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Production Note 


This book was produced with the VAX DOCUMENT electronic publishing 
system, a software tool developed and sold by DIGITAL. In this system, 
writers use an ASCII text editor to create source files containing text and 
English-like code; this code labels the structural elements of the document, 
such as chapters, paragraphs, and tables. The VAX DOCUMENT software, 
which runs on the VMS operating system, interprets the code to format the 
text, generate a table of contents and index, and paginate the entire document. 
Writers can print the document on the terminal or line printer, or they can use 
DIGITAL-supported devices, such as the LNOQ3 laser printer and PostScript® 
printers (PrintServer 40 or LNO3R ScriptPrinter), to produce a typeset-quality 
copy containing integrated graphics. 


[ PostScript is a registered trademark of Adobe Systems, Inc. 
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Preface 


The VAX-11/725 and VAX-11/730 are entry-level single unibus systems 
with 3Mb of main memory. Both systems work as small multi-user systems 
that offer a full range of communication options. On the VAX-11/730 you 
can expand the unibus and its main memory (up to 5Mb). It also has a 
backup battery feature. 


Both computers offer full compatibility with software written and used on 
other VAX computers, including VMS software, optional software products, 
and applications software. 


This guide often refers to the following products by their abbreviated names: 
© The VAX-11/725 computer is referred to as the VAX-11/725. 
¢ The VAX-11/730 computer is referred to as the VAX-11/730. 


VMS Installation and Operations: VAX-11/725,730 contains specific installation 
and operations information for the VAX-11/725 and VAX-11/730 computers. 
Store this guide in the binder that contains the current version of the VMS 
Release Notes. Place it in the section after the VMS Release Notes. 


Intended Audience 


This guide is for system managers, operators, and users of the VAX-11/730 
and VAX-11/725. 





Document Structure 


VMS Installation and Operations: VAX-11/725,730 is organized into two 
parts. Part I provides an overview of the system and covers installation and 
post-installation procedures. Part II describes operations that you perform 
frequently on the system such as system startup, shutdown, and backup. 


Part I 


e® Chapter 1 describes the VMS installation, upgrade, and update 
procedures. 


¢ Chapter 2 describes the console subsystem. 


¢ Chapter 3 summarizes the basic information you need to know before 
installing the VMS operating system. 


¢ Chapter 4 describes how to install the VMS operating system on a 
VAX-11/725. 


¢ Chapter 5 describes how to install the VMS operating system on a 
UDA-based VAX-11/730 from magnetic tape. 


¢ Chapter 6 describes how to install the VMS operating system on a 
UDA-based VAX-11/730 from an RA60 disk. 


*® Chapter 7 describes how to install the VMS operating system on a 
VAX-11/730 with an R80/RLO02 configuration. 
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Preface 


Chapter 8 lists the tasks you should perform after you install the VMS 
operating system. 


Chapter 9 describes the VMS User Environment Test Package (UETP) and 
how to use it to test the system. 


Part II 


Chapter 10 contains instructions for starting up the system. It also 
describes system shutdown procedures. 


Chapter 11 describes backup procedures you should perform on a regular 
basis. 


Appendix A contains instructions for installing a line printer on a 
VAX-11/730. 


The Glossary lists and defines terms. 





Associated Documents 


The following documents may be useful: 


xiv 


VMS Release Notes—provides notes on various aspects of the VMS 
operating system. Most importantly, the release notes contain a 
description of the upgrade and update procedures. The release notes 
also contain the latest information regarding your VAX computer. You 
should read the current version of the VMS Release Notes before installing, 
upgrading, or updating the VMS operating system or using your VAX 
computer. 


The hardware manuals supplied with your VAX computer provide 
detailed information on system hardware. 


Preface 





Conventions 





Convention 





RET 


CTRL/C 


$ SHOW TIME 
O5-JUN-1988 11:55:22 


$ TYPE MYFILE.DAT 


input-file, ... 


[logical-name] 


quotation marks 
apostrophes 


In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 

a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 
key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 


A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 


In examples, system output (what the system 
displays) is shown in black. User input (what 
you enter) is shown in red. 


In examples, a vertical series of periods, or 
ellipsis, means either that not all the data that 
the system would display in response to a 
command is shown or that not all the data a 
user would enter is shown. 


In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 


Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 


The term quotation marks is used to refer 
to double quotation marks (”). The term 

apostrophe (') is used to refer to a single 
quotation mark. 





New and Changed Features 


Before VMS Version 5.0 the VAX/VMS System Manager’s Reference Manual 
included specific information on booting and installing standalone BACKUP 
on the different VAX computers. The Guide to VAX/VMS Software Installation 
provided information on console subsystems, disk and tape drives, and 
booting during installation. There were also 19 separate booklets with 
step-by-step instructions for installing the VMS operating system. 


With VMS Version 5.0 DIGITAL is providing one guide for each family of 
VAX computers. Each guide provides a single source of information on the 
following: 


* Disk and tape drives and the console subsystem 

e Installing the VMS operating system on your particular VAX computer 
e Testing the system with UETP 

¢ Startup and shutdown operations 

e Installing and booting standalone BACKUP 

e Backing up and restoring the system disk 

* Backing up the console media (if applicable) 

The guide for your VAX computer provides all the specific information 


you need to install the VMS operating system and perform daily startup, 
shutdown, and backup operations. 


Note the following Version 5.0 restrictions for installing the VMS operating 
system: 


* Dual system disks are no longer supported. 


° The entire VMS operating system will not fit on an RC25, RD52, or RKO7 
system disk. DIGITAL suggests that you add more disk storage to your 
system. 


¢ The VAX-11/782 is no longer supported. 
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Part | 


Part | describes installation and post-installation procedures. 





1 The Installation, Upgrade, and Update Procedures 


This chapter describes what happens during the installation, upgrade, and 
update procedures. It also tells you when you should do an installation, an 
upgrade, or an update and refers you to the appropriate documentation. 


Before you install or upgrade the VMS operating system, read this chapter. 


1.1 What Happens During an Installation 


CAUTION: 


When you install the VMS operating system, the installation procedure does 
the following: 


e Initializes the system disk, erasing its contents 


¢ Transfers the VMS files from the distribution media to the system disk 


Use the installation procedure under the following conditions: 


e If your VAX computer is new (it has never had any version of the 
operating system running on it). 


e If your VAX computer is running a version of the VMS operating system 
and you want to destroy the contents of the system disk (both VMS and 
user files). 


e If you are running the VMS operating system, but are not able to perform 
an upgrade. For example, if you do not have a standard version of the 
VMS operating system on your system disk, the upgrade procedure will 
not work correctly. 


If you are going to install the VMS operating system, read Chapters 1 
through 3 of this guide and follow the appropriate installation procedure. 


The installation procedure initializes the system disk, erasing its 
contents. For this reason, use the installation procedure only on new | 
VAX computers or if you want to destroy the contents of the system disk. 





1.2 What Happens During an Upgrade 


When you upgrade the VMS operating system, the upgrade procedure does 
the following: 


* Makes room for the upgrade by purging and deleting some VMS files, but 
leaves some of the VMS files and all the user files intact 


¢ Transfers the VMS files from the distribution media to the system disk 
© Merges the old VMS files and the new VMS files 


¢ Cleans up files and structures used only during the upgrade 


The Installation, Upgrade, and Update Procedures 
1.2 What Happens During an Upgrade 


CAUTION: 


In most cases, if you are already running a standard version of the VMS 
operating system, you can use the upgrade procedure to obtain a higher 
version of it. The upgrade procedure does not initialize the system disk. 


The upgrade procedure will not work correctly if you have changed the 
names of system directories on your system disk or if you have deleted 
VMS files from them. Restore your VMS system disk to a standard system 
before attempting an upgrade. 


Because not all the VMS files can fit on an RC25 or RKO7 system disk, you 
cannot upgrade an RC25 or RKO7 system disk. You will have to perform 
an installation to get the next highest version of the VMS operating 
system. Before installing the new version, make a backup copy of your 
current system disk. 


If you are going to perform an upgrade, see the current version of the VMS 
Release Notes for a step-by-step description of the upgrade procedure. 





1.3 What Happens During an Update 


1-2 


CAUTION: 


The update procedure is used to make minor fixes to the operating system. 
When you update the VMS operating system, the update procedure does the 
following: 


e Applies patches to some VMS files 
¢ Replaces some VMS files 


After installing or upgrading the VMS operating system, you perform an 
update. This update is referred to as the mandatory update. The directions for 
an installation or an upgrade tell you when to perform the mandatory update. 


Some maintenance releases of the VMS operating system are also applied 
with the update procedure. The directions for a maintenance update are in 
the VMS Release Notes. 


The update procedure will not work correctly if you have changed the 
names of system directories on your system disk or if you have deleted 
VMS files from them. Restore your VMS system disk to a standard system 
before attempting an update. 





2 The Console Subsystem 


Before you install the VMS operating system, you need to be familiar 

with the VAX-11/725 and VAX-11/730 console subsystems. In general, 

use the console subsystem to examine and deposit data in memory or 
processor registers, stop the processor, and boot the operating system. During 
installation, use it to boot the processor and monitor the installation process. 
The console subsystem consists of the following: 


¢ Console terminal 

¢ Processor control panel 

¢ Two TU58 tape cassette drives 

* Console command language 

¢ Optional remote diagnostic port 

This chapter describes the parts of the console subsystem that you use to 


install the VMS operating system. For a complete description of the console 
subsystem, see the hardware manuals for your VAX computer. 





2.1 The Console Terminal 
There are two types of console terminals, local and remote. 


The local console terminal is a hardcopy terminal attached to the system. 
It prints a log of processor activities. Use it to control and monitor system 
operations. 


If you purchased the optional remote diagnostics port, a DIGITAL diagnostics 
center uses a remote console terminal (located at the diagnostics center) to 
control the system during diagnostic testing. 


Per a) 


2.2 The Processor Control Panel 


The VAX-11/725 and the VAX-11/730 processor control panels are nearly 
identical. The panel is located on the front of the computer and includes the 
following: 


¢ Four indicator lights 

e An AUTO RESTART/BOOT switch 

¢ A 6-position keylock switch 

Figure 2-1 shows the VAX-11/730 processor control panel. The only 
difference between it and the VAX-11/725 is that there is no BATT indicator 
on the VAX-11/725 (it does not have a battery backup feature). Also, on the 


VAX-11/725 the settings for the keylock switch are labeled with complete 
words. 


2.2.1 


The Console Subsystem 
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Indicator Lights 


2-2 





Figure 2-1 VAX-—11/730 Processor Control Panel 
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Table 2-1 describes the indicator lights on the VAX-11/725 and VAX-11/730 
processor control panels. 


Table 2-1 VAX-—11/725 and VAX—11/730 Indicator Lights on the 
Processor Control Panel 


Label Meaning 


RUN Glows red when the processor is running and the console subsystem is 
in program mode. 


DC ON’ Glows red when DC power supply voltages are within the operating 
limits. Flashes when one or more of the DC power supply voltages is 
not within operating limits. 


BATT' Tells you the condition of the backup battery. 
Steady glow The backup battery is at greater than 90% of full 
power. 


Slow flash (less The backup battery is at less than 90% of full power 
than once every —_and is charging. 


second) 
Quick flash The backup battery is at less than 90% of full power 
and is discharging. 
No light The backup battery unit is broken or is not present. 
R/D Glows red when the system is connected to the remote diagnostic 


service. Flashes when remote diagnostic procedures are being 
performed on the system. 


1The VAX-11/725 does not have a BATT light. 


The Console Subsystem 
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2.2.2 Switches 


2.2.2.1 


2.2.2.2 


There are two switches on the processor control panel, an AUTO 
RESTART/BOOT switch and a 6-position keylock switch. 


AUTO RESTART/BOOT Switch 
The AUTO RESTART/BOOT switch has the following three settings: 


BOOT Push the switch to the BOOT position to boot the system with 
the default boot command procedure. You cannot leave the 
AUTO RESTART /BOOT switch set to BOOT. 


ON lf the AUTO RESTART/BOOT switch is set to ON, the system 
reboots automatically when one of the events listed below 
occurs. 

OFF lf the AUTO RESTART/BOOT switch is set to OFF, the console- 


mode prompt (> > > ) appears on the console terminal when 
one of the events listed below occurs. 


The setting of the AUTO RESTART/BOOT switch determines what happens 
after any of the following events: 


¢ The power is turned on. 


¢ A power failure occurs and the contents of memory are not preserved by 
the battery backup unit. 


¢ A shutdown occurs and you enter Y at the auto reboot prompt. - 


¢ The microprogram detects an error halt condition (for example, a HALT 
instruction executed in kernel mode). 


Set the AUTO RESTART/BOOT switch to ON during normal system 
operations. 


Keylock Switch 

The 6-position keylock switch controls system power and determines how the 
processor responds to commands from local and remote console terminals. 
Table 2-2 describes each keylock switch setting. Note that the power supply 
is turned off only when this switch is set to OFF. 


Table 2-2 Keylock Switch Settings 





Setting Meaning 
OFF Power is off. 
STD BY Power is supplied to the writable control store, main memory, and 


the time-of-year clock. 


LOCAL You can use the local console terminal in console mode to control 
the processor, or in program mode as a user terminal. A DIGITAL 
diagnostics center cannot use the remote console terminal when 
the switch is set to LOCAL. 
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2.2 The Processor Control Panel 


Table 2—2 (Cont.) Keylock Switch Settings 
Setting Meaning 


LOC DSBL = You cannot use the local console terminal in console mode to 
control the processor.'You can use it in program mode as a user 
terminal. A DIGITAL diagnostics center cannot use the remote 
console terminal when the switch is set to LOC DSBL. 


REM DSBL You cannot use the local console terminal. A DIGITAL diagnostics 
center can use the remote console terminal as a user terminal in 
program mode, but not in console mode. 


REMOTE A DIGITAL diagnostics center is in control of the remote console 
terminal. You cannot use the local console terminal. However, the 
DIGITAL diagnostics center can enter commands to restore control 
to the local console terminal. 





'Pressing the AUTO RESTART/BOOT switch to the BOOT position has no effect since 
BOOT is a console mode command. 





The Console Tape Cassette Drives 


VAX-—11/730 


The VAX-11/725 and the VAX-11/730 have two TU58 tape cassette drives, 
referred to as CSA1 and CSA2. 


The CSA1 drive holds the tape cassettes that do the following tasks: 

¢ Install updates 

¢ Install optional software products 

¢ Boot standalone BACKUP 

The CSA2 drive holds the tape cassette that contains the boot command 


procedures that boot, or load, the operating system from the system disk into 
processor memory. This tape cassette is referred to as the console TU58. 


There are two VAX-11/730 system controller configurations: 
e Integrated Disk Controller (IDC) 
¢ UNIBUS Disk Adapter (UDA) 


The tape cassette drives are located in different positions on these two 
configurations. 


Figure 2-2 shows the locations of the tape cassette drives on an IDC-based 
VAX-11/730. The CSA1 drive is located at the front of the CPU cabinet, 
above the processor control panel. There are indicator lights on both sides of 
the CSA1 drive. The light on the left glows when the CSA1 drive is active. 
The light on the right glows when the CSA2 drive is active. To access the 
CSA2 drive, slide out the CPU cabinet. The CSA2 drive is located on the 
right side. 


2.3.2 


The Console Subsystem 
2.3 The Console Tape Cassette Drives 


WARNING: Be sure to extend the safety foot located under the CPU cabinet before 


you slide it out. 
Figure 2-2 TU58 Locations on an IDC-Based VAX-11/730 
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Figure 2-3 shows the locations of the tape cassette drives on a UDA-based 
VAX-11/730. Both drives are located at the front of the computer. CSA1 is 
located on the left side of the control panel and is labeled 0. CSA2 is located 
on the right side of the control panel and is labeled 1. Each drive has a light 
that glows when the drive is active. 


Figure 2-3 TU58 Locations on a UDA-Based VAX—11/730 
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VAX-11/725 


Figure 2-4 shows the location of the tape cassette drives on the VAX-11/725. 
CSA1 is located at the front of the CPU cabinet, and CSA2 is located at the 
right side of the cabinet. 


The light labeled 0, located to the left of CSA1, glows when CSA1 is active. 
The light labeled 1, located to the right of CSA1, glows when CSA2 is active. 


The Console Subsystem 
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Figure 2—4 TU58 Locations on a VAX-11/725 
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2.3.3 Inserting and Removing a Tape Cassette 
Insert a tape cassette into a tape cassette drive as follows: 
1 Find the slotted opening at the front of the drive. 


2 Ifa tape cassette is already in the drive, remove it by gripping it with 
your fingertips and pulling it gently towards you. 


3 Hold a tape cassette with the label facing up and the RECORD tab facing 
forward. 


4 Insert the tape cassette into the drive and gently push it into the slot until 
it stops. When fully inserted, the tape cassette protrudes about one-half 
inch from the drive. Figure 2-5 shows how to insert a tape cassette in a 
tape cassette drive. 


The Console Subsystem 
2.3 The Console Tape Cassette Drives 


Figure 2—5 Inserting a Tape Cassette 
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2.4 The Console Command Language 


The console subsystem runs in two different modes, program mode and 
console mode. 


Program mode—When the console subsystem is in program mode the 
VMS operating system is running and the dollar-sign prompt ($) is 
displayed. You can enter DCL commands, run programs, and receive 
system messages. 


If the VMS operating system is running and you want to go to console 
mode, follow the shutdown procedure described in Chapter 10. 


Console mode—When the console subsystem is in console mode, the 
VMS operating system is not running and the CPU is stopped. The 
console-mode prompt (> > > ) is displayed. In console mode you 
control and monitor system operations. Table 2-3 describes the most 
commonly used console mode commands. 


To go from console mode to program mode, boot the VMS operating 
system as described in Chapter 10. 


Table 2-3 describes the console mode commands you use during the 
installation procedure. 


o 


Table 2—3 Commonly Used Console Mode Commands 





Command Definition 





BOOT Executes a console command procedure that loads a 
VAX software program into memory. The command 
procedure then transfers control to the program and puts 
the console subsystem in program mode. During the 
installation procedure, use the abbreviation, B, for the 
BOOT command. 


The Console Subsystem 
2.4 The Console Command Language 
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Table 2—3 (Cont.) Commonly Used Console Mode Commands 


Command Definition 


DEPOSIT Puts a value in the specified register or memory location. 
During the installation procedure, use the abbreviation, D, 
for the DEPOSIT command. 


HALT Resets the default console conditions after the processor 
stops. 





For more information on the console subsystem and command language, see 
the hardware manual supplied with your VAX computer. 


3.1 


3.2 


3.3 





Before Installing VMS 


This chapter describes the following: 
e Terms and procedures you need to know before you do an installation 


¢ Choosing the correct installation procedure 


The Distribution Media and the System Disk 


When you install the VMS operating system, you work primarily with the 
distribution media and the system disk. The distribution media are the disks 
or tapes that VMS is supplied on. The VMS operating system is supplied on 
the distribution media in a format that the processor cannot readily use. 


The installation procedure transfers the operating system from the distribution 
media to your system disk and puts it in a format that the system can use. 

A system disk is the disk that contains (or will contain) the VMS operating 
system in a usable format. 


Choosing the Correct Installation Procedure 


The VMS installation procedure you follow depends on what type of 
distribution media you have (magnetic tape, RC25 disk cartridge, RA60 disk, 
etc.) and what type of VAX computer you have. For example, if you have 
a VAX-11/730 and a magnetic tape distribution kit, follow the installation 
procedure in Chapter 5. 





Device Names 


At different times during the installation you need to tell the system which 
drive contains the distribution media and which drive contains the system 
disk. You refer to a drive with its device name. A device name has the 
following format: 


ddcu 
where: 


e dd is the device code. The device code tells what type of device you are 
using. 


e cis the controller designation. A controller designation can be one of the 
alphabetic letters A through Z. The controller designation, along with the 
unit number, identifies the location of the device. 


3.3.1 
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3.3 Device Names 


Boot Names 


¢ wis the unit number. A unit number can be a decimal number in the 
range of 0 to n.! The unit number, along with the controller designation, 
identifies the location of the device. 


Note: The only part of the name you can readily modify is the unit number. 


The device code is fixed, and the controller designation is made when the 
hardware is installed. 


For example, CSA1 and CSA2 are the device names for the tape cassette 
drives on the console subsystem. CS is the device code. A names the 
controller (the controller provides the interface between the processor and 
the drive). 1 and 2 are their unit numbers. 


Table 3-1 lists the device names for the different drives that can be part of a 
VAX-11/730 system. Table 3-2 lists the device names for the different drives 
that can be part of a VAX-11/725 system. 


Before you begin the installation procedure, make sure you know the device 
names for both the drive that will hold the distribution media and the drive 
that will hold the system disk. 





This section explains what you need to know to boot the system during the 
installation procedure. For complete information on booting the system for 
daily operations, see Chapter 10. 


When you boot the system, use the BOOT command followed by a boot 
name. Boot names have the following format: 


ddu 
where: 


e dd is the device code. Table 3-1 and Table 3-2 list the device codes to 
use in device names and boot names. Note that for some types of drives 
the device code is different when it is part of a boot name. For example, 
the device code for an RA60 drive is usually DJ. However, when you boot 
from an RA60 drive, the device code is DU. 


¢ wis the unit number 


The following example boots the system from an RA81 disk drive with a unit 
number of one: 


>>> B DUL 


The boot name (in this case DU1) is the abbreviation for a boot command 
procedure. The boot command procedure is a file stored on the console 
TUS58. It contains the list of instructions needed to load system software into 
memory. The instructions for booting the system are slightly different for 
each drive. Therefore, a boot command procedure exists for each drive that 
the system supports. The following are some examples of boot command 
procedures: 


DU0OBOO.CMD 


' The first drive on a controller is usually assigned a unit number of zero, the next drive is assigned a unit 


number of one, and so on. The range is determined by the bus that supports the device. For example, most 
MASSBUS disks can have unit numbers in the range of 0 to 7. UDA disks can have unit numbers in the range 


of 0 to 254. 
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3.3 Device Names 


DU1BO0.CMD 


Before you begin the installation procedure, make sure you know the boot 
name for the drive that will hold the system disk. 


Table 3-1 lists the device names and the boot names for the different drives 
that can be part of a VAX-11/730 system. You can use any of the disk drives 
except the RLO2 to hold the system disk. 


Table 3—1 Device Names and Boot Names for the VAX—11/730 


Device Boot 
Device Name’ Name’ 
Console drives (TU58) CSA1,CSA2 CSs1 
RA6O disk drive DJcu DUu 
RA70, RA80, and RA81 DUcu DUu 
disk drives 
RLO27and R80 disk drives DOQcu DQu 
TS11 and TU80 magnetic MScu - 
tape drives 


TU81 magnetic tape drive MUcu - 


1e stands for the controller designation and u stands for the unit number. 


2Do not use an RLO2 as a system disk. 


The only two drives you can have on a VAX-11/725 system are the fixed 
RC25 disk and the removable RC25 disk. Table 3-2 lists the device names 
and the boot names for these drives. 


Table 3-2 Device Names and Boot Names for the VAX—11/725 


Device Boot 
Device Name Name 
Console drives (TU58) CSA1,CSA2 CS1,- 
Removable RC25 DAAO DUO 
Fixed RC25 DAA1 DU1 


4.1 


Installing VMS on a VAX—11/725 


CAUTION: 


This chapter describes installing the VMS operating system on a VAX-11/725 
from a removable RC25 disk cartridge to a fixed RC25 system disk. 


The software installation procedure overwrites the contents of the system 
disk. For your own protection, make a backup copy of your current 
system disk before you install the new version of the VMS operating 
system. 


he 


Before You Start 


Note: 


Before you install the VMS operating system, do the following: 


e Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for the VAX-11/725. 


e Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. The VAX-11/725 distribution kit should contain 
the following: 


— Two RC25 disk cartridges that contain standalone BACKUP and the 
VMS required, library, and optional save sets 


— One or more TU58 tape cassettes that contain the mandatory update 


If your kit is incomplete, notify the DIGITAL Software Distribution Center. 
Request priority shipment of any missing items. 


In addition, you need the most recent version of the console TUS8. 


During the installation procedure, the VMS files are transferred from the 
RC25 distribution disk cartridge to the fixed RC25 system disk. The procedure 
consists of the following stages: 


1. Turning on the system 

2 Preparing the RC25 disk cartridge drive 

3 Booting standalone BACKUP 

4 Creating the system disk 

5 Installing the mandatory update and running AUTOGEN 

The entire procedure takes approximately one and a half hours. 

The screen displays and examples in this manual depict the installation 


of VMS Version 5.0. Your screen displays reflect the version that you are 
installing. 
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4.2 Turning On the System 


This procedure assumes that the system is not turned on when you start the 
installation. The following steps describe turning on the system and setting 
the switches on the processor control panel. 


1. Turn on the console terminal. 


2 Check the CSA2 tape cassette drive in the console subsystem. Make sure 
the console TUS8 is in the drive. 


3 Set the AUTO RESTART switch to OFF. 


4 From the OFF position, set the keylock switch to LOCAL. The console 
driver should begin loading. The light next to the CSA2 drive glows red, 
and the procedure displays the following message: 


VERSION 03.00 
>>>@POWER . CMD 
>>>L/C CONSOLE .CPU 


If you do not see this type of message within two minutes, turn the 
keylock switch back to the OFF position. Wait 15 seconds and repeat this 
step. If the system still does not respond after you have tried five times, 
call DIGITAL Field Service. 


5 As power is applied to the system, the DC ON light goes on. It takes 
approximately 10 minutes for the console driver to finish loading. When 
the driver has finished loading, the light next to the CSA2 drive goes out. 
The console-mode prompt (> > > ) is displayed on the console terminal. 


6 To prepare the RC25 disk cartridge drive, go to Section 4.3. 


4.3 Preparing the RC25 Disk Cartridge Drive 


Figure 4—1 shows the control panel for the removable and the fixed RC25 
drives. 
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Figure 4-1 RC25 Control Panel and Indicators 
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To set up the RC25 disk cartridge drive, do the following: 


1 


Check the front panel of the RC25 disk cartridge drive. If the EJECT 
button is lit, proceed to step 2. If the EJECT button is not lit, push the 
RUN button out to spin down the drive. As the drive spins down, the 
RUN light flashes. When the drive stops, the RUN light goes out and the 
EJECT light comes on. 


Press the EJECT button to open the door of the disk drive. 


Insert the RC25 disk cartridge labeled VMS V5.0 BIN RC25 1/2 in the 
drive and close the door. 


Check the front panel of the RC25 disk cartridge drive again. If the 
WRITE PROTECT/REMOVE button is lit, push it out to turn it off. If the 
WRITE PROTECT/FIXED button is lit, push it out to turn it off. 


Press the RUN button to bring the RC25 disk cartridge drive to operating 
speed. The RUN light flashes. When the drive is at operating speed, the 
RUN light glows steadily. 


To boot standalone BACKUP, go to Section 4.4. 





4.4 Booting Standalone BACKUP 


This section describes the steps for booting standalone BACKUP. Standalone 
BACKUP lets you transfer the VMS required save set from the RC25 disk 
cartridge to your fixed RC25 system disk. Boot standalone BACKUP from the 
RC25 disk cartridge. The procedure takes approximately three minutes. 
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At the console-mode prompt (> > > ), enter the BOOT command 
followed by the boot name of the RC25 disk cartridge drive. Enter the 
following command and press RETURN: 


>>> B DUO 


The light next to the CSA2 drive glows red, and the procedure displays 
the following messages: 
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@DD1 : DUOBOO. CMD 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH: :MM): 31-DEC-1988 15:00 
The procedure displays a list of the devices on your system. For example: 


Available device DAAO: device type RC25 
Available device DAA1: device type RC25 


Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


When standalone BACKUP finishes booting, it displays an identification 
message followed by the dollar-sign prompt ($): 


“4BACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


5 To create the system disk, go to Section 4.5, 


4.5 Creating a System Disk 


This section describes the steps for transferring the VMS files from the RC25 
disk cartridge to the fixed RC25 system disk. The VMS files are stored on the 
RC25 disk cartridge as three save sets: required, library, and optional. 


1 


1 


To transfer the required save set to your system disk, enter the following 
command and press RETURN. Make sure you include the colon (:) at 
the end of each name and that you use zeros in the device names and in 
VMS050. 


$ BACKUP/VERIFY DAAO: VMSO50.B/SAVE_SET DAA1: 


The required save set on the RC25 disk cartridge is transferred to the fixed 
RC25 system disk.! This takes approximately eight minutes. During the 
process the procedure displays the following message: 


“%BACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the required save set has been transferred to 
the system disk and the files are being checked for errors. Approximately 
three minutes later the procedure displays the following message: 


The BACKUP command creates a system disk that includes a DIGITAL-provided set of volume parameters, 


including a CLUSTER_SIZE (disk access scheme) of one. For more information, see the note at the end of 


Section 11.2. 
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“%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application disk is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. 


To boot the fixed RC25 system disk, enter the following command and 
press RETURN: 


>>> B DUI 
Booting the system takes approximately four minutes. 


When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


The procedure displays warning messages, similar to the following, 
that the VMS license is not registered. Continue with the installation 
procedure. Follow the instructions for registering the VMS license 
after you finish the installation. 


VAX/VMS Version BI50 Major version id = 01 Minor version id = 00 
VAX/VMS Version 5.0 Installation Procedure 
WRI, ~=OPCOM 31-DEC-1988 15:00:00.00 %ANALURLAAA 
Logfile has been initialized by operator _OPAO: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR .LOG; 1 


/LICENSE-F-EMTLDB, License database contains no license records 
%LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-Y%LICENSE-F-NOLICENSE, no license is active for this software product 
-{%LICENSE-I-SYSMGR, please see your system manager 

WIAA ~=OPCOM 31-DEC-1988 15:00:00.00 %ULAKRALALL 

Message from user SYSTEM 

Y%LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
-%LICENSE-I-SYSMGR, please see your system manager 


Startup processing continuing... 


Please enter the date and time (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 
The procedure displays the following message: 


The full VMS kit will not fit on your system disk... 
The OPTIONAL save set will not be restored. 

If you wish to restore files from this save set, 
execute the following command after you finish the 
installation procedure: 


$ RUN SYS$UPDATE: VMSTAILOR 


Continue with the installation procedure. After you finish the installation, 
follow the instructions for small system disks in Section 8.2. 


The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the system 
disk. You can press RETURN to accept the default volume label, 
VMSRLS5, or you can enter a volume label of your choice. The volume 
label can be 1 to 12 characters long; spaces are not allowed. For example: 
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If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 
Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12-characters in length. If you 
wish to use the default name of VMSRL5 just press RETURN in response to 
the next question. 


Enter the volume label for this system disk (no spaces) [VMSRL5]: SYSDSK 


The procedure asks which drive holds the distribution disk. Enter the 
following and press RETURN: 


Enter the name of the drive holding the distribution media (DDCU): DAAO: 


During the next 20 minutes the procedure displays the following 
messages: 


4MOUNT-I-MOUNTED, VMSOSO mounted on _DDAO: 


Restoring LIBRARY saveset. 
4BACKUP-I-STARTVERIFY, starting verification pass 


Creating [VMS$COMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 
PAGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


Will this node be a cluster member? (Y/N) 


Type N (for NO) and press RETURN. 


10 The procedure asks you for new passwords for the SYSTEM, SYSTEST, 


and FIELD accounts. Passwords must be at least eight characters in 
length; they do not appear on the display. Press RETURN after you enter 
each one. After you enter the passwords, the procedure checks each 

one to make sure it meets the requirements for a good password. For 
example: 


Now we will ask you for new passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


Enter new password for account SYSTEM: PANCAKES 
Re-enter the password for account SYSTEM for verification: PANCAKES 


“%UAF-I-MDFYMSG, user record(s) updated 


Enter new password for account SYSTEST: BRATWURST 
Re-enter the password for account SYSTEST for verification: BRATWURST 


“ZUAF-I-MDFYMSG, user record(s) updated 


Enter new password for account FIELD: ZIRHUMBA 
Re-enter new password for account FIELD for verification: ZIRHUMBA 


%UAF-I-MDFYMSG, user record(s) updated 


The procedure will now check and verify passwords for the 
following accounts: 


SYSTEM, SYSTEST, FIELD 


Passwords that can be guessed easily will not be accepted. 


If the procedure verifies the passwords, it displays the following 
messages: 


%VMS-I-PWD_OKAY, account password for SYSTEM verified 
%VMS-I-PWD_OKAY, account password for SYSTEST verified 
“NMS-I-PWD_OKAY, account password for FIELD verified 
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If you enter a password incorrectly or if the password is too easy to guess, 
the procedure displays error messages similar to the following: 


“VMS-W-PWD_INVALID, account password for SYSTEM is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N (for 
NO) and press RETURN. When the procedure asks if you want to enter 

a new password, type Y (for YES) and press RETURN. Then enter a new 
password. For example: 


Do you want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEM account. The 
password you select must be at least 8 characters in length and may not 
be the same as the name of the account. 


New password: WILLIWAW 
Verification: WILLIWAW 


,UAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_SET, primary password for account SYSTEM set 


After you have entered the passwords, the procedure creates your 
RIGHTS database and displays the following messages: 


Creating RIGHTS database file. SYS$SYSTEM:RIGHTSLIST .DAT 
Ignore any "%SYSTEM-F-DUPIDENT, duplicate identifier" errors 


After the procedure creates the RIGHTS database, go to Section 4.6 to 
install the mandatory update. 


4.6 Installing the Mandatory Update and Running AUTOGEN 


Follow the directions in this section to install the mandatory update and run 
AUTOGEN. AUTOGEN evaluates your hardware configuration and estimates 
typical workloads. It then sets system parameters, the sizes of the page, swap, 
and dump files, and the contents of VMSIMAGES.DAT. When AUTOGEN 
finishes, the installation procedure is complete. 
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After the procedure creates the RIGHTS database, it displays the 
following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


- DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of the system 
libraries are shipped in a data compressed format. If you have enough disk 
space, you may decompress them for faster access. Use SYS$UPDATE: LIBDECOMP.COM 
to data expand the libraries. If you choose not to decompress these libraries 
there will be a negative impact on the performance of the HELP and LINK 
commands. 


- BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX processor. 


Continuing with VAX/VMS V5.0 Installation Procedure. 


Configuring all devices on the system. 
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You must now install the MANDATORY UPDATE, which can be found 
on a separate distribution volume. 


VAX/VMS Software Product Installation Procedure V5.0 


It is 31-DEC-1988 at 15:00 
Enter a question mark (7) at any time for help. 


The procedure asks you for the device name of the drive that contains the 
mandatory update. Enter the following and press RETURN: 


*Where will the distribution volumes be mounted: CSA1 
The procedure displays the following messages: 


U%DCL-I_ALLOC, _CSA1: allocated 


Please mount the first volume of the set on CSA1:. 
*Are you ready? 


Place the tape cassette labeled VAX/VMS V5.0 BIN TUS58 MANDATORY 
UPDATE in the CSA1 drive. When you are ready to continue, type Y and 
press RETURN. The procedure displays the following series of messages 
and asks if you want to purge files: 


“4MOUNT-I-MOUNTED, VMSMUP mounted on _CSA1: 
The following products will be processed: 
VMSMUP V5.0 
Beginning installation of VMSMUP V5.0 at 15:00 
“VMSINSTAL-I-RESTORE, Restoring product saveset A... 
Installing VMS V5 mandatory update 
Do you want to purge files replaced by this installation [YES]? 


Press RETURN (for YES) and go to the next step. 


Depending on the version of the VMS operating system that you 
are installing, the mandatory update procedure might ask for certain 
information. Read the screen displays for instructions. 


If there is more than one TUS8 tape cassette containing the mandatory 
update, you will be asked to change tape cassettes at some point during 
the procedure. When the procedure is finished, it displays the following 
message: 


VMSINSTAL procedure done at 15:00 
AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 
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Note: 


After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After the system shuts down, the procedure reboots the system if there 
is a default boot command procedure for the system disk on the console 
TU58. If the system does not reboot automatically, enter the following 
BOOT command: 


>>> B DU1 


After the system reboots, the procedure displays the following message: 


The procedure might display warning messages that the VMS 
license must be registered. Be sure to register this license when 
the installation procedure finishes, as described in Chapter 8. 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


You have successfully installed the VMS operating systen. 
The system is now executing the STARTUP procedure. 

Please await the completion of STARTUP before logging 
into the system (approximately three minutes) . 


WIAA ~=OPCOM 31-DEC-1988 15:00.00.00 %ALAAKALALA 
Logfile has been initialized by operator _OPAO: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR. LOG; 1) 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 


Startup processing continuing... 


YSET-I-INTSET, login interactive limit=64, current interactive value = 0 
31-DEC-1988 15:00:00.00 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 
Accounting information: 
Buffered I/O count: 859 Peak working set size: 565 
Direct I/0 count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: 1) 
Charged CPU time: 0 00:00:55.23 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 


Welcome to VAX/VMS V5.0 


USERNAME: SYSTEM 
PASSWORD: PANCAKES 


Welcome to VAX/VMS V5.0 


When you press RETURN, the VMS operating system prompt ($) is 
displayed. 


If you forget the password, follow the instructions for breaking into the 
system in the Guide to Setting Up a VMS System. 
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10 Check the printout on the console terminal. AUTOGEN might have 


11 


displayed error messages in the following format: 


2 2 oR ok a ok ok ko ko kk oe s 

YAUTOGEN-W-DSKSPC, The disk on which DISK$VAXVMSRL5: (SYSO.SYSEXE] PAGEFILE.SYS 
resides would be over 95% full if it were modified to hold 20000 
blocks. 

2 a a ea ak ak ck oc 


YAUTOGEN-I-NOCHANGE, DISK$VAXVMSRLS : [SYSO .SYSEXE] PAGEF ILE .SYS 
will not be modified. 


If you see any messages of this type, you need to free some space on 
the system disk. Combine the dump file and the page file so that the 
dump file information is saved in the page file. Run SYSGEN and set the 
SAVEDUMP parameter to one. While you are logged into the SYSTEM 
account, enter the following commands and press RETURN after each 
one: 


$ RUN SYS$SYSTEM : SYSGEN 
SYSGEN> USE CURRENT 
SYSGEN> SET SAVEDUMP 1 
SYSGEN> WRITE CURRENT 
SYSGEN> EXIT 


For more information, see Section 7.1 in the Guide to Maintaining a VMS 
System. 


Enter the following command and press RETURN to shutdown the VMS 
operating system: 


$ OSYS$SYSTEM : SHUTDOWN 


Answer the questions. When the procedure asks if an automatic system 
reboot, should be performed, press RETURN for NO. When the procedure 
is finished, it displays the following message: 


SYSTEM SHUTDOWN COMPLETE - USE CONSOLE TO HALT SYSTEM 


12 Press CTRL/P to put the system in console mode. 
13 Spin down the RC25 disk cartridge drive. Remove the distribution RC25 


disk cartridge and store it in a safe place. Spin up the drive. 


14 Enter the following command and press RETURN to reboot the system: 


>>> B DUI 


15 There are several things you must do before you can use the system. For 


complete information, see Chapter 8. 
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Installing VMS on a VAX—11/730 from Magnetic 


Tape 


CAUTION: 


Before You Start 


Note: 


This chapter describes installing the VMS operating system on a VAX-11/730 
from a magnetic tape drive. Use this procedure only if you have a UDA-based 
VAX-11/730. 


The software installation procedure overwrites the contents of the system 
disk. Use the VMS installation procedure only if your VAX computer is 
new, or if you want to destroy the contents of the system disk. If your 
system disk contains files that you want to save, you should upgrade 

to the new version of VMS. For a complete description of the upgrade 
procedure, see the current version of the VMS Release Notes. 





Before you install the VMS operating system, do the following: 


* Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for your VAX-11/730. 


¢ Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. The VAX-11/730 magnetic tape distribution kit 
should contain the following: 


— A magnetic tape that contains the VMS required, library, and optional 
save sets 


— Five TU58 tape cassettes that contain standalone BACKUP 


— One or more TUS58 tape cassettes that contain the mandatory update 


If your kit is incomplete, notify the DIGITAL Software Distribution Center. 
Request priority shipment of any missing items. 


In addition, you need the most recent version of the console TU58. 


During the installation procedure, the VMS files are transferred from the 
distribution magnetic tape to the system disk. The procedure consists of the 
following stages: : 


1 Turning on the system 

Preparing the disk and tape drives 
Booting standalone BACKUP 
Creating the system disk 


of W N 


Installing the mandatory update and running AUTOGEN 


The entire procedure takes approximately one and a half hours. 


The screen displays and examples in this manual depict the installation 
of VMS Version 5.0. Your screen displays reflect the version that you are 
installing. 
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5.2 Turning On the System 


This procedure assumes that the system is not turned on when you start the 
installation. The following steps describe turning on the system and setting 
the switches on the processor control panel. 


1 
2 


3 
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Turn on the console terminal. 


Check the CSA2 tape cassette drive in the console subsystem. Make sure 
the console TU58 is in the drive. 


Set the AUTO RESTART switch to OFF. 


From the OFF position, set the keylock switch to LOCAL. The console 
driver should begin loading. The activity light for the CSA2 drive glows 
red, and the procedure displays the following message: 


VERSION 03.00 
>>>@POWER . CMD 
>>>L/C CONSOLE .CPU 


If you do not see this type of message within two minutes, turn the 
keylock switch back to the OFF position. Wait 15 seconds and repeat this 
step. If the system still does not respond after you have tried five times, 
call DIGITAL Field Service. 


As power is applied to the system, the DC ON light goes on. It takes 
approximately 10 minutes for the console driver to finish loading. When 
the driver has finished loading, the activity light for the CSA2 drive goes 
out. The console-mode prompt (> > > ) is displayed on the console 
terminal. 


To prepare the disk and tape drives, go to Section 5.3. 


5.3 Preparing the Disk and Tape Drives 


To set up the disk and tape drives you use during the installation, do the 
following: 


1 
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Decide which drive will hold the distribution magnetic tape and which 
drive will hold the system disk. The drive that holds the system disk 
must have a unit number in the range of 0 to 3. 


Thread the tape on the tape drive and put the drive on line. 


Place a scratch disk in the drive for the system disk (unless the system 
disk is fixed). 


Spin up the system disk but do not write-protect it. 
To boot standalone BACKUP, go to Section 5.4. 
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5.4 Booting Standalone BACKUP 


This section describes the steps for booting standalone BACKUP. Standalone 
BACKUP lets you transfer the VMS required save set from the distribution 
magnetic tape to your system disk. You need the five TU58 tape cassettes 
from the VMS distribution kit. They are labeled as follows: 


Paper Label’ Volume Label” 
S/A BKUP TU58 1/5 SYSTEM_1 
S/A BKUP T58 2/5 SYSTEM_2 
S/A BKUP TU58 3/5 SYSTEM_3 
S/A BKUP TU58 4/5 SYSTEM_4 
S/A BKUP TU58 5/5 BACKUP 


1A paper label is the label affixed to a tape cassette. 


2A volume label is the name VMS uses to refer to a tape cassette. During the installation 
the procedure displays the volume label, not the paper label, in messages. 


The procedure asks you to place the five tape cassettes containing standalone 
BACKUP, successively, in the console drive. 


1 


Make sure the console TU58 is in the CSA2 tape cassette drive. Insert 
the tape cassette labeled S/A BKUP TU58 1/5 in the CSA1 drive. At the 
console-mode prompt (> > > ), enter the following command and press 
RETURN: 


>>> B CS1 
After a short time, the procedure displays the following message: 


Please remove the volume "SYSTEM_1" from the console device. 


Insert the first standalone system volume and enter "YES" when ready: 
Ignore this message and let the tape cassettes remain where they are. 


Type Y (for YES) and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_1", please stand by... 


Please remove the volume "SYSTEM_1" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


Remove the S/A BKUP TU58 1/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 2/5. When you are 
ready to continue, type Y and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_2", please stand by... 
VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


Please remove the volume "SYSTEM_2" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


5-3 


Installing VMS on a VAX—11/730 from Magnetic Tape 
5.4 Booting Standalone BACKUP 


4 Remove the S/A BKUP TU58 2/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 3/5. When you are 
ready to continue, type Y and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_3", please stand by... 


Please remove the volume "SYSTEM_3" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


5 Remove the $/A BKUP TU58 3/5 tape cassette and insert the tape 
cassette labeled S/A BKUP TU58 4/5 in the drive. When you are ready 
to continue, type Y and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_4", please stand by... 


6 The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 
7 The procedure displays a list of the devices on your system. For example: 


Available device DJAQO: device type RA6O 
Available device DJA1: device type RAGO 


Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


8 The procedure displays the following message: 
Please remove the volume "SYSTEM_4" from the console device. 
Insert the standalone application volume and enter "YES" when ready: 


9 Remove the S/A BKUP TU58 4/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 5/5. When you are 
ready to continue, type Y and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume 'BACKUP', please stand by... 


10 When standalone BACKUP finishes booting, it displays an identification 
message followed by the dollar-sign prompt ($): 


¥YBACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


Note: Do not remove the S/A BKUP TU58 5/5 tape cassette from the CSA1 
drive until you are asked to do so. 


11 To create the system disk, go to Section 5.5. 
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5.5 Creating a System Disk 


This section describes the steps for transferring the VMS files from the 
distribution magnetic tape to your system disk. The VMS files are stored 
on the distribution magnetic tape as three save sets: required, library, and 
optional. 


The instructions refer to the source-drive and the target-drive where: 


1 


The source-drive is the drive that holds the distribution magnetic tape 


The target-drive is the drive that holds the system disk 


Determine the device names for the source-drive and the target-drive using 
Table 3-1. Write these names on a piece of paper. You will need this 
information throughout the installation. 


To transfer the required save set to your system disk, use the BACKUP 
command in the following format: 


$ BACKUP/VERIFY source-drive : VMSO50.B/SAVE_SET target-drive: 


Substitute the appropriate device names for source-drive and target-drive. 
Make sure you put a colon (:) after each device name and that you use 
zeros in the device names and in VMS050. 


For example, if your system has the following configuration: 


e <A TU80 source-drive with a controller designation of A and a unit 
number of zero 


e An RA60 target-drive with a controller designation of A and a unit 
number of one 


Enter the following command and press RETURN: 
$ BACKUP/VERIFY MSAO:VMSO50.B/SAVE_SET DJA1: 


The required save set on the distribution magnetic tape is transferred 
to the system disk.! This takes approximately 15 minutes. During the 
process the procedure displays the following message: 


%BACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the required save set has been transferred to 
the system disk and the files are being checked for errors. Approximately 
15 minutes later the procedure displays the following message: 


“%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


3 Press CTRL/P to put the system in console mode. 
4 Remove the S/A BKUP TU58 5/5 tape cassette from the CSA1 drive. 


1 


The BACKUP command creates a system disk that includes a DIGITAL-provided set of volume parameters, 


including a CLUSTER_SIZE (disk access scheme) of one. For more information, see the note at the end of 


Section 11.2. 
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Note: 


To boot the system disk, enter the BOOT command in the following 
format: 


>>>B ddu 


Substitute the boot name of the target-drive for ddu. For a list of boot 
names, see Table 3-1. 


For example, suppose the system disk is on an RA60 disk drive and the 
unit number is one. Enter the following command and press RETURN: 


>>>B DUI 
Booting the system takes approximately four minutes. 


When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


The procedure displays warning messages, similar to the following, 
that the VMS license is not registered. Continue with the installation 
procedure. Follow the instructions for registering the VMS license 
after you finish the installation. 


VAX/VMS Version BI50 Major version id = 01 Minor version id = 00 
VAX/VMS Version 5.0 Installation Procedure 


thhhhhbhhhh OPCOM 31-DEC-1988 15:00:00.00 %KUAAUALAN 
Logfile has been initialized by operator _OPAO: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR. LOG; 1 


%LICENSE-F-EMTLDB, License database contains no license records 
%LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
-/LICENSE-I-SYSMGR, please see your system manager 

UWihbhkbhkhh OPCOM 31-DEC-1988 15:00:00.00 IILIUINL 

Message from user SYSTEM 

“%LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-/LICENSE-F-NOLICENSE, no license is active for this software product 
-/LICENSE-I-SYSMGR, please see your system manager 


Startup processing continuing... 
Please enter the date and time (DD-MMM-YYYY HH:MM) : 31-DEC-1988 15:00 


The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the system 
disk. You can press RETURN to accept the default volume label, 
VMSRLS5, or you can enter a volume label of your choice. The volume 
label can be 1 to 12 characters long; spaces are not allowed. For example: 


If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 
Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12~-characters in length. If you 
wish to use the default name of VMSRLS5 just press RETURN in response to 
the next question. 


Enter the volume label for this system disk (no spaces) [VMSRL5]: SYSDSK 


The procedure asks which drive holds the distribution magnetic tape. 
Enter the device name of the source-drive. For example, suppose the 
source-drive is a TU80 tape drive with a controller designation of A and a 
unit number of zero. Enter the following command and press RETURN: 
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Enter the name of the drive holding the distribution media (DDCU) : MSAQO: 


9 During the next 30 minutes the procedure displays the following 
messages: 


%MOUNT-I-MOUNTED, VMSOSO mounted on _MSAO: 
Restoring LIBRARY saveset. 


%BACKUP-I-STARTVERIFY, starting verification pass 


Restoring OPTIONAL saveset. 
YBACKUP-I-STARTVERIFY, starting verification pass 


Creating [VMS$COMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 
PAGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


Will this node be a cluster member? (Y/N) 

10 Type N (for NO) and press RETURN. 

11 The procedure displays the following message: 
You may now remove the distribution kit from _$MSAO: 
Remove the distribution tape from the drive. 


12 The procedure asks you for new passwords for the SYSTEM, SYSTEST, 
and FIELD accounts. Passwords must be at least eight characters in 
length; they do not appear on the display. Press RETURN after you enter 
each one. After you enter the passwords, the procedure checks each 
one to make sure it meets the requirements for a good password. For 
example: 


Now we will ask you for new passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


Enter new password for account SYSTEM: PANCAKES 
Re-enter the password for account SYSTEM for verification: PANCAKES 


%UAF-I-MDFYMSG, user record(s) updated 


Enter new password for account SYSTEST: BRATWURST 
Re-enter the password for account SYSTEST for verification: BRATWURST 


%UAF-I-MDFYMSG, user record(s) updated 


Enter new password for account FIELD: ZIRHUMBA 
Re-enter new password for account FIELD for verification: ZIRHUMBA 


YUAF-I-MDFYMSG, user record(s) updated 


The procedure will now check and verify passwords for the 
following accounts: 


SYSTEM, SYSTEST, FIELD 


Passwords that can be guessed easily will not be accepted. 


If the procedure verifies the passwords, it displays the following 
messages: 


%VMS-I-PWD_OKAY, account password for SYSTEM verified 
“VMS-I-PWD_OKAY, account password for SYSTEST verified 
“VMS-I-PWD_OKAY, account password for FIELD verified 
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If you enter a password incorrectly or if the password is too easy to guess, 
the procedure displays error messages similar to the following: 


“VMS-W-PWD_INVALID, account password for SYSTEM is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N (for 
NO) and press RETURN. When the procedure asks if you want to enter 

a new password, type Y (for YES) and press RETURN. Then enter a new 
password. For example: 


Do you want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEM account. The 
password you select must be at least 8 characters in length and may not 
be the same as the name of the account. 


New password: WILLIWAW 
Verification: WILLIWAW 


“4UAF-I-MDFYMSG, user record(s) updated 
“#NMS-I-PWD_SET, primary password for account SYSTEM set 


After you have entered the passwords, the procedure creates your 
RIGHTS database and displays the following message: 


Creating RIGHTS database file. SYS$SYSTEM:RIGHTSLIST.DAT 
Ignore any "%SYSTEM-F-DUPIDENT, duplicate identifier" errors 


After the procedure creates the RIGHTS database, go to Section 5.6 to 
install the mandatory update. 


5.6 Installing the Mandatory Update and Running AUTOGEN 


Follow the directions in this section to install the mandatory update and run 
AUTOGEN. AUTOGEN evaluates your hardware configuration and estimates 
typical workloads. It then sets system parameters, the sizes of the page, swap, 
and dump files, and the contents of VMSIMAGES.DAT. When AUTOGEN 
finishes, the installation procedure is complete. 
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After the procedure creates the RIGHTS database, it displays the 
following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


- DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of the system 
libraries are shipped in a data compressed format. If you have enough disk 
space, you may decompress them for faster access. Use SYS$UPDATE: LIBDECOMP.COM 
to data expand the libraries. If you choose not to decompress these libraries 
there will be a negative impact on the performance of the HELP and LINK 
commands . 


- BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX processor. 


Continuing with VAX/VMS V5.0 Installation Procedure. 


Configuring all devices on the system. 
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You must now install the MANDATORY UPDATE, which can be found 
on a separate distribution volume. 


VAX/VMS Software Product Installation Procedure V5.0 


It is 31-DEC-1988 at 15:00 
Enter a question mark (?) at any time for help. 


2 The procedure asks you for the device name of the drive that contains the 
mandatory update. Enter the following and press RETURN: 


*Where will the distribution volumes be mounted: CSA1 
The procedure displays the following messages: 


¥%DCL-I_ALLOC, _CSA1: allocated 


Please mount the first volume of the set on CSA1i:. 
*Are you ready? 


3 Place the tape cassette labeled VAX/VMS V5.0 BIN TU58 MANDATORY 
UPDATE in the CSA1 drive. When you are ready to continue, type Y and 
press RETURN. The procedure displays the following series of messages 
and asks if you want to purge files: 


Y%MOUNT-I-MOUNTED, VMSMUP mounted on _CSA1: 
The following products will be processed: 
VMSMUP V5.0 
Beginning installation of VMSMUP V5.0 at 15:00 
%VMSINSTAL-I-RESTORE, Restoring product saveset A... 
Installing VMS V5 mandatory update 
Do you want to purge files replaced by this installation [YES]? 
Press RETURN (for YES) and go to the next step. 


4 Depending on the version of the VMS operating system that you 
are installing, the mandatory update procedure might ask for certain 
information. Read the screen displays for instructions. 


If there is more than one TU58 tape cassette containing the mandatory 
update, you will be asked to change tape cassettes at some point during 
the procedure. When the procedure is finished, it displays the following 
message: 


VMSINSTAL procedure done at 15:00 
5 AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 


5-9 


Installing VMS on a VAX—11/730 from Magnetic Tape 
5.6 Installing the Mandatory Update and Running AUTOGEN 


5-10 


6 


Note: 


After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After the system shuts down, the procedure reboots the system if there 
is a default boot command procedure for the system disk on the console 
TU58. If the system does not reboot automatically, enter the BOOT 
command in the following format and press RETURN: 


>>> B ddu 


Substitute the boot name of the target-drive for ddu. For a list of boot 
names, see Table 3-1. 


For example, suppose the system disk is on an RA60 disk drive and the 
unit number is one. Enter the following command and press RETURN: 


>>> B DUI 


After the system reboots, the procedure displays the following message: 


The procedure might display warning messages that the VMS 
license must be registered. Be sure to register this license when 
the installation procedure finishes, as described in Chapter 8. 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


You have successfully installed the VMS operating system. 
The system is now executing the STARTUP procedure. 
Please await the completion of STARTUP before logging 
into the system (approximately three minutes) . 


Wks OPCOM 31-DEC-1988 15:00.00.00 %ALKLUMMGA 
Logfile has been initialized by operator _OPAO: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR. LOG; 1) 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 


Startup processing continuing... 


4SET-I-INTSET, login interactive limit=64, current interactive value = 0 
31-DEC-1988 15:00:00.00 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 
Accounting information: 
Buffered I/O count: 859 Peak working set size: 565 
Direct 1/0 count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: i?) 
Charged CPU time: O 00:00:55.23 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 
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Welcome to VAX/VMS V5.0 


USERNAME: SYSTEM 
PASSWORD: PANCAKES 


Welcome to VAX/VMS V5.0 


When you press RETURN, the VMS operating system prompt ($) is 
displayed. 


If you forget the password, follow the instructions for breaking into the 
system in the Guide to Setting Up a VMS System. 


10 There are several things you must do before you can use the system. For 
complete information, see Chapter 8. 
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6.1 


Disk 


CAUTION: 


Before You Start 


Note: 


Installing VMS on a VAX—11/730 from an RA6O 


This chapter describes installing the VMS operating system on a VAX-11/730 
from an RA60 disk drive. Use this procedure only if you have a UDA-based 
VAX-11/730. 


The software installation procedure overwrites the contents of the system 
disk. Use the VMS installation procedure only if your VAX computer is 
new, or if you want to destroy the contents of the system disk. If your 
system disk contains files that you want to save, you should upgrade 

to the new version of VMS. For a complete description of the upgrade 
procedure, see the current version of the VMS Release Notes. 





Before you install the VMS operating system, do the following: 


¢ Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for your VAX-11/730. 


® Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. The VAX-11/730 RA60 distribution kit should 
contain the following: 


— An RA60 disk that contains standalone BACKUP and the VMS 
required, library, and optional save sets 


~— One or more TUS58 tape cassettes that contain the mandatory update 


If your kit is incomplete, notify the DIGITAL Software Distribution Center. 
Request priority shipment of any missing items. 


In addition, you need the most recent version of the console TU58. 


During the installation procedure, the VMS files are transferred from the 
distribution magnetic tape to the system disk. The procedure consists of the 
following stages: 


1 Turning on the system 
Preparing the disk drives 
Booting standalone BACKUP 
Creating the system disk 


af W N 


Installing the mandatory update and running AUTOGEN 


The entire procedure takes approximately one and a half hours. 


The screen displays and examples in this manual depict the installation 
of VMS Version 5.0. Your screen displays reflect the version that you are 
installing. 
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6.2 Turning On the System 


This procedure assumes that the system is not turned on when you start the 
installation. The following steps describe turning on the system and setting 
the switches on the processor control panel. 


1 
2 


3 
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Turn on the console terminal. 


Check the CSA2 tape cassette drive in the console subsystem. Make sure 
the console TU58 is in the drive. 


Set the AUTO RESTART switch to OFF. 


From the OFF position, set the keylock switch to LOCAL. The console 
driver should begin loading. The light next to the CSA2 drive glows red, 
and the procedure displays the following message: 


VERSION 03.00 
>>>QPOWER . CMD 
>>>L/C CONSOLE .CPU 


If you do not see this type of message within two minutes, turn the 
keylock switch back to the OFF position. Wait 15 seconds and repeat this 
step. If the system still does not respond after you have tried five times, 
call DIGITAL Field Service. 


As power is applied to the system, the DC ON light goes on. It takes 
approximately 10 minutes for the console driver to finish loading. When 
the driver has finished loading, the light next to the CSA2 drive goes out. 
The console-mode prompt (> > > ) is displayed on the console terminal. 


To prepare the disk drives, go to Section 6.3. 





6.3 Preparing the Disk Drives 


To set up the disk drives you use during the installation, do the following: 


1 
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Decide which drive will hold the RA60 distribution disk and which drive 
will hold the system disk. Both drives must have a unit number in the 
range of 0 to 3. 


Place the RA60 distribution disk in the disk drive. Write-protect it and 
spin it up. 


Place a scratch disk in the drive for the system disk (unless the system 
disk is fixed). 


Spin up the system disk but do not write-protect it. 
To boot standalone BACKUP, go to Section 6.4. 
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6.4 Booting Standalone BACKUP 


6.4 Booting Standalone BACKUP 


This section describes the steps for booting standalone BACKUP. Standalone 
BACKUP lets you transfer the VMS required save set from the RA60 
distribution disk to your system disk. You boot standalone BACKUP from the 
RA60 distribution disk. The procedure takes approximately three minutes. 
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Boot standalone BACKUP from the RA60 distribution disk. At the 
console-mode prompt (> > > ), enter the BOOT command in the 
following format: 


>>> B DUu 


Substitute the unit number of the RA60 drive for u. For example, suppose 
the system disk is on an RA60 disk drive and the unit number is one. 
Enter the following command and press RETURN: 


>>> B DUI 


The light next to the CSA2 drive glows red, and the procedure displays a 
series of messages. For example: 


@DD1 : DUOBOO . CMD 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 
The procedure displays a list of the devices on your system. For example: 


Available device DJAO: device type RA60 
Available device DJA1: device type RA6O 


Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


When standalone BACKUP finishes booting, it displays an identification 
message followed by the dollar-sign prompt ($): 


%BACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


To create the system disk, go to Section 6.5. 
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Creating a System Disk 


This section describes the steps for transferring the VMS files from the 
RA60 distribution disk to your system disk. The VMS files are stored on the 
distribution disk as three save sets: required, library, and optional. 


The instructions refer to the source-drive and the target-drive where: 


1 


3 
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The source-drive is the drive that holds the RA60 distribution disk 
The target-drive is the drive that holds the system disk 


Determine the device names for the source-drive and the target-drive using 
Table 3-1. Write these names on a piece of paper. You will need this 
information throughout the installation. 


To transfer the required save set to your system disk, use the BACKUP 
command in the following format: 


$ BACKUP/VERIFY source-drive:VMSO50.B/SAVE_SET target-drive: 


Substitute the appropriate device names for source-drive and target-drive. 
Make sure you put a colon (:) after each device name and that you use 
zeros in the device names and in VMS050. 


For example, if your system has the following configuration: 


e An RA60 source-drive with a controller designation of A and a unit 
number of zero 


* An RA80 target-drive with a controller designation of A and a unit 
number of one 


Enter the following command and press RETURN: 
$ BACKUP/VERIFY DJAO:VMSO50.B/SAVE_SET DUA1: 


The required save set on the distribution disk is transferred to the system 
disk.! This takes approximately two minutes. During the process the 
procedure displays the following message: 


/%BACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the required save set has been transferred to 
the system disk and the files are being checked for errors. Approximately 
two minutes later the procedure displays the following message: 
Y%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 


If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. 


The BACKUP command creates a system disk that includes a DIGITAL-provided set of volume parameters, 


including a CLUSTER_SIZE (disk access scheme) of one. For more information, see the note at the end of 


Section 11.2. 
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Note: 
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To boot the system disk, enter the BOOT command in the following 
format: 


>>> B ddu 


Substitute the boot name of the target-drive for ddu. For a list of boot 
names, see Table 3-1. 


For example, suppose the system disk is on an RA80 disk drive and the 
unit number is one. Enter the following command and press RETURN: 


>>> B DUI 
Booting the system takes approximately four minutes. 


When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


The procedure displays warning messages, similar to the following, 
that the VMS license is not registered. Continue with the installation 
procedure. Follow the instructions for registering the VMS license 
after you finish the installation. 


VAX/VMS Version BI50 Major version id = 01 Minor version id = 00 
VAX/VMS Version 5.0 Installation Procedure 
Khhhdhh OPCOM 31-DEC-1988 15:00:00.00 “KAAMALhL 
Logfile has been initialized by operator _OPAQ: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR. LOG; 1 


/,LICENSE-F-EMTLDB, License database contains no license records 
%,LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
-%LICENSE-I-SYSMGR, please see your system manager 

Khhihhhhhhh OPCOM 31-DEC-1988 15:00:00.00 ‘AKAMA 

Message from user SYSTEM 

%LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
-%LICENSE-I-SYSMGR, please see your system manager 


Startup processing continuing... 


Please enter the date and time (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 


The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the system 
disk. You can press RETURN to accept the default volume label, 
VMSRLS, or you can enter a volume label of your choice. The volume 
label can be 1 to 12 characters long; spaces are not allowed. For example: 
If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 


Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12-characters in length. If you 

wish to use the default name of VMSRLS5 just press RETURN in response to 

the next question. 

Enter the volume label for this system disk (no spaces) [VMSRL5}: SYSDSK 

The procedure asks which drive holds the distribution disk. Enter the 
device name of the source-drive in the following format: 


Enter the name of the drive holding the distribution media (DDCU): DJcu: 


Substitute the controller designation for c and the unit number for u. 
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For example, suppose the source-drive is an RA60 disk drive with 
a controller designation of A and a unit number of zero. Enter the 
following command and press RETURN: 


Enter the name of the drive holding the distribution media (DDCU): DJAO: 


During the next 30 minutes the procedure displays the following 
messages: 


“%MOUNT-I-MOUNTED, VMSO50 mounted on _DJAO: 
Restoring LIBRARY saveset. 


ZBACKUP-I-STARTVERIFY, starting verification pass 


Restoring OPTIONAL saveset. 
ZBACKUP-I-STARTVERIFY, starting verification pass 


Creating [VMS$COMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 
PAGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


Will this node be a cluster member? (Y/N)) 
Type N (for NO) and press RETURN. 


10 The procedure displays the following message: 
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You may now remove the distribution kit from _$DJAO: 
Remove the distribution disk from the drive. 


The procedure asks you for new passwords for the SYSTEM, SYSTEST, 
and FIELD accounts. Passwords must be at least eight characters in 
length; they do not appear on the display. Press RETURN after you enter 
each one. After you enter the passwords, the procedure checks each 

one to make sure it meets the requirements for a good password. For 
example: 


Now we will ask you for new passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


Enter new password for account SYSTEM: PANCAKES 
Re-enter the password for account SYSTEM for verification: PANCAKES 


“ZUAF-I-MDFYMSG, user record(s) updated 


Enter new password for account SYSTEST: BRATWURST 
Re-enter the password for account SYSTEST for verification: BRATWURST 


“ZUAF-I-MDFYMSG, user record(s) updated 


Enter new password for account FIELD: ZIRHUMBA 
Re-enter new password for account FIELD for verification: ZIRHUMBA 


“%UAF-I-MDFYMSG, user record(s) updated 


The procedure will now check and verify passwords for the 
following accounts: 


SYSTEM, SYSTEST, FIELD 


Passwords that can be guessed easily will not be accepted. 


If the procedure verifies the passwords, it displays the following 
messages: 


%VMS-I-PWD_OKAY, account password for SYSTEM verified 
%VMS-I-PWD_OKAY, account password for SYSTEST verified 
%NMS-I-PWD_OKAY, account password for FIELD verified 
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If you enter a password incorrectly or if the password is too easy to guess, 
the procedure displays error messages similar to the following: 


YVMS-W-PWD_INVALID, account password for SYSTEM is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N (for 
NO) and press RETURN. When the procedure asks if you want to enter 

a new password, type Y (for YES) and press RETURN. Then enter a new 
password. For example: 


Do you want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEM account. The 
password you select must be at least 8 characters in length and may not 
be the same as the name of the account. 


New password: WILLIWAW 
Verification: WILLIWAW 


UAF-I-MDFYMSG, user record(s) updated 
4NMS-I-PWD_SET, primary password for account SYSTEM set 


12 After you have entered the passwords, the procedure creates your 


RIGHTS database and displays the following message: 


Creating RIGHTS database file. SYS$SYSTEM:RIGHTSLIST .DAT 
Ignore any "%4SYSTEM-F-DUPIDENT, duplicate identifier" errors 


13 After the procedure creates the RIGHTS database, go to Section 6.6 to 


install the mandatory update. 


6.6 Installing the Mandatory Update and Running AUTOGEN 


Follow the directions in this section to install the mandatory update and run 
AUTOGEN. AUTOGEN evaluates your hardware configuration and estimates 
typical workloads. It then sets system parameters, the sizes of the page, swap, 
and dump files, and the contents of VMSIMAGES.DAT. When AUTOGEN 
finishes, the installation procedure is complete. 


1 


After the procedure creates the RIGHTS database, it displays the 
following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


- DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of the system 
libraries are shipped in a data compressed format. If you have enough disk 
space, you may decompress them for faster access. Use SYS$UPDATE : LIBDECOMP .COM 
to data expand the libraries. If you choose not to decompress these libraries 
there will be a negative impact on the performance of the HELP and LINK 
commands . 


- BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX processor. 


Continuing with VAX/VMS V5.0 Installation Procedure. 


Configuring all devices on the system. 
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You must now install the MANDATORY UPDATE, which can be found 
on a separate distribution volume. 


VAX/VMS Software Product Installation Procedure V5.0 


It is 31-DEC-1988 at 15:00 
Enter a question mark (7) at any time for help. 


The procedure asks you for the device name of the drive that contains the 
mandatory update. Enter the following and press RETURN: 


*Where will the distribution volumes be mounted: CSAi 
The procedure displays the following messages: 


Y%DCL-I_ALLOC, _CSA1: allocated 


Please mount the first volume of the set on CSA1:. 
*Are you ready? 


Place the tape cassette labeled VAX/VMS V5.0 BIN TU58 MANDATORY 
UPDATE in the CSA1 drive. When you are ready to continue, type Y and 
press RETURN. The procedure displays the following series of messages 
and asks if you want to purge files: 


%MOUNT-I-MOUNTED, VMSMUP mounted on _CSA1: 
The following products will be processed: 
VMSMUP V5.0 
Beginning installation of VMSMUP V5.0 at 15:00 
4“NMSINSTAL-I-RESTORE, Restoring product saveset A... 
Installing VMS V5 mandatory update 
Do you want to purge files replaced by this installation [YES]? 
Press RETURN (for YES) and go to the next step. 


Depending on the version of the VMS operating system that you 
are installing, the mandatory update procedure might ask for certain 
information. Read the screen displays for instructions. 


If there is more than one TU58 tape cassette containing the mandatory 
update, you will be asked to change tape cassettes at some point during 
the procedure. When the procedure is finished, it displays the following 
message: 


VMSINSTAL procedure done at 15:00 
AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN ~ Please wait. 
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Note: 


After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After the system shuts down, the procedure reboots the system if there 
is a default boot command procedure for the system disk on the console 
TU58. If the system does not reboot automatically, enter the BOOT 
command in the following format and press RETURN: 


>>> B ddu 


Substitute the boot name of the target-drive for ddu. For a list of boot 
names, see Table 3-1. 


For example, suppose the system disk is on an RA60 disk drive and the 
unit number is one. Enter the following command and press RETURN: 


>>> B DUL 
After the system reboots, the procedure displays the following message: 


The procedure might display warning messages that the VMS 
license must be registered. Be sure to register this license when 
the installation procedure finishes, as described in Chapter 8. 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


You have successfully installed the VMS operating system. 
The system is now executing the STARTUP procedure. 

Please await the completion of STARTUP before logging 
into the system (approximately three minutes). 
hhkhkhhhhht OPCOM 31-DEC-1988 15:00.00.00 %ALKALLLAGA 
Logfile has been initialized by operator _OPAO: 

Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR .LOG; 1) 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 


Startup processing continuing... 


¥SET-I-INTSET, login interactive limit=64, current interactive value = 0 
31-DEC-1988 15:00:00.00 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 
Accounting information: 

Buffered I/0 count: 859 Peak working set size: 565 
Direct I/O count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: te) 
Charged CPU time: O 00:00:55.23 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 
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Welcome to VAX/VMS V5.0 


USERNAME: SYSTEM 
PASSWORD: PANCAKES 


Welcome to VAX/VMS V5.0 


When you press RETURN, the VMS operating system prompt ($) is 
displayed. 


If you forget the password, follow the instructions for breaking into the 
system in the Guide to Setting Up a VMS System. 


10 There are several things you must do before you can use the system. For 
complete information, see Chapter 8. 
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7.1 


Disk 


CAUTION: 


Before You Start 


Note: 


Installing VMS on a VAX—11/730 from an RLO2 


This chapter describes installing the VMS operating system on a VAX-11/730 
from an RLO2 distribution disk to an R80 system disk. Use this procedure 
only if you have an IDC-based VAX-11/730. 


The software installation procedure overwrites the contents of the system 
disk. Use the VMS installation procedure only if your VAX computer is 
new, or if you want to destroy the contents of the system disk. If your 
system disk contains files that you want to save, you should upgrade 

to the new version of VMS. For a complete description of the upgrade 
procedure, see the current version of the VMS Release Notes. 





Before you install the VMS operating system, do the following: 


¢ Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for your VAX-11/730. 


¢ Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. The VAX-11/730 RLO2 distribution kit should 
contain the following: 


— Three RLO2 disks that contain standalone BACKUP and the VMS 
required, library, and optional save sets 


— One or more TU58 tape cassettes that contain the mandatory update 


If your kit is incomplete, notify the DIGITAL Software Distribution Center. 
Request priority shipment of any missing items. 


In addition, you need the most recent version of the console TU58. 


During the installation procedure, the VMS files are transferred from the 
RLO2 distribution disk to the R80 system disk. The procedure consists of the 
following stages: 


1. Turning on the system 
Preparing the disk drives 
Booting standalone BACKUP 
Creating the system disk 


a f& WwW DN 


Installing the mandatory update and running AUTOGEN 


The entire procedure takes approximately one and a half hours. 


The screen displays and examples in this manual depict the installation 
of VMS Version 5.0. Your screen displays reflect the version that you are 
installing. 
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Turning On the System 


This procedure assumes that the system is not turned on when you start the 
installation. The following steps describe turning on the system and setting 
the switches on the processor control panel. 


1. Turn on the console terminal. 


2 Check the tape cassette drive in the console subsystem. Make sure the 
console TU58 is in the drive. 


3 Set the AUTO RESTART switch to OFF. 


4 From the OFF position, set the keylock switch to LOCAL. The console 
driver should begin loading. The activity light for the CSA2 drive glows 
red, and the procedure displays a message similar to the following: 


VERSION 03.00 
>>>@POWER . CMD 
>>>L/C CONSOLE. CPU 


If you do not see this type of message within two minutes, turn the 
keylock switch back to the OFF position. Wait 15 seconds and repeat this 
step. If the system still does not respond after you have tried five times, 
call DIGITAL Field Service. 


5 As power is applied to the system, the DC ON light goes on. It takes 
approximately 10 minutes for the console driver to finish loading. When 
the driver has finished loading, the activity light for the CSA2 drive goes 
out. The console-mode prompt (> > > ) is displayed on the console 
terminal. 


6 To prepare the disk drives, go to Section 7.3. 





Preparing the Disk Drives 
To set up the disk drives you use during the installation, do the following: 


1. Place the distribution disk labeled VMS V5.0 REQUIRED RLO2 #1 in the 
RLO2 disk drive. Write-protect it and spin it up. 


2 Spin up the R80 disk drive but do not write-protect it. 
3 To boot standalone BACKUP, go to Section 7.4. 





Booting Standalone BACKUP 


This section describes the steps for booting standalone BACKUP. Standalone 
BACKUP lets you transfer the VMS required save set from the RLO2 
distribution disk to your R80 system disk. You boot standalone BACKUP 
from the RLO2 distribution disk. The procedure takes approximately three 
minutes. 


1 At the console-mode prompt (> > > ), enter the BOOT command in the 
following format and press RETURN: 


7-2 


Installing VMS on a VAX-—11/730 from an RLO2 Disk 
7.4 Booting Standalone BACKUP 


>>> B DQu 


Substitute the unit number of the RLO2 drive for u. For example, 
suppose the unit number is one. Enter the following command and 
press RETURN: 


>>> B DQI 


2. The activity light for the CSA2 drive glows red, and the procedure 
displays the following series of messages: 


@DD1 : DUOBOO. CMD 


VAX/VMS Version V5.0 Major version id = O01 Minor version id = 00 
The RUN light glows red at this point. 


3 The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 
4 The procedure displays a list of the devices on your system. For example: 


Available device DJAO: device type RA6O 
Available device DJA1: device type RA60 


Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


5 When standalone BACKUP finishes booting, it displays an identification 
message followed by the dollar-sign prompt ($): 


/BACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


6 To create the system disk, go to Section 7.5. 





7.5 Creating a System Disk 


This section describes the steps for transferring the VMS files from the RLO2 
distribution disk to your R80 system disk. The VMS files are stored on the 
RLO2 distribution disk as three save sets: required, library, and optional. 


1 To transfer the required save set to your system disk, enter the following 
command and press RETURN: 


$ BACKUP/VERIFY DQcu:VMSO50.B/SAVE_SET DQcu: 


The first DQcu refers to the RLO2 disk drive. The second DQcu refers to 
the R80 disk drive. In both cases, c stands for the controller designation 

and u stands for the unit number. Make sure you include a colon (:) at 

the end of each name and that you use zeros in the device names and in 
VMS050. 
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For example, if your system has the following configuration: 


¢ An RLO2 source-drive with a controller designation of A and a unit 
number of zero 


¢ An R80 target-drive with a controller designation of A and a unit 
number of one 


Enter the following command and press RETURN: 
$ BACKUP/VERIFY DQAO:VMSO50.B/SAVE_SET DQA1: 


The required save set on the distribution disk is transferred to the system 
disk.! This takes approximately two minutes. During the process the 
procedure displays the following messages: 


“%BACKUP-I-STARTVERIFY, starting verification pass 
%BACKUP-I-RESUME, resuming operation on volume 2 
“%BACKUP-I-READYREAD, mount volume 2 on _SABAKUP$DQAO: for reading 
Enter "YES" when ready: 


2 Spin down the RLO2 drive and remove the VMS V5.0 REQUIRED RL02 
#1 disk. Place the disk labeled VMS V5.0 LIBRARY RLO2 #2 in the drive. 
Spin up the RLO2 drive. When the READY light turns on, type Y (for 
YES) and press RETURN. The procedure displays the following messages: 


“%BACKUP-I-STARTVERIFY, starting verification pass 
“BACKUP-W-INCFILATK, incomplete file attribute data... 


Approximately two minutes later the procedure displays the following 
message: 


“%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


3 Press CTRL/P to put the system in console mode. 


4 To boot the R80 system disk, enter the BOOT command in the following 
format and press RETURN: 


>>> B DQu 


Substitute the unit number of the R80 disk drive for u. For example, 
suppose the R80 system disk has a unit number of one. Enter the 
following command and press RETURN: 


>>> B DQ1 
The procedure displays the following series of messages: 


>>>@DD1 : DQOBO0 . CMD 
>>>I 
>>>D/G/L 0 00A80003 


Booting the system takes approximately four minutes. 


1 The BACKUP command creates a system disk that includes a DIGITAL-provided set of volume parameters, 


including a CLUSTER_SIZE (disk access scheme) of one. For more information, see the note at the end of 
Section 11.2. 
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When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


The procedure displays warning messages, similar to the following, 
that the VMS license is not registered. Continue with the installation 
procedure. Follow the instructions for registering the VMS license 
after you finish the installation. 


VAX/VMS Version BI50 Major version id = 01 Minor version id = 00 
VAX/VMS Version 5.0 Installation Procedure 
YI, ~=OPCOM 31-DEC-1988 15:00:00.00 %AAALLALUG 


Logfile has been initialized by operator _OPAO: 
Logfile is SYS$SYSROOT: [SYSMGR] OPERATOR. LOG; 1 


/,LICENSE-F-EMTLDB, License database contains no license records 
YLICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
-%LICENSE-I-SYSMGR, please see your system manager 

WI ~=OPCOM 31-DEC-1988 15:00:00.00 KARAWAANLAL 

Message from user SYSTEM 

YLICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-Y%,LICENSE-F-NOLICENSE, no license is active for this software product 
-Y%LICENSE-I-SYSMGR, please see your system manager 


Startup processing continuing... 


Please enter the date and time (DD-MMM-YYYY HH:MM): 31-DEC-1988 15:00 


The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the system 
disk. You can press RETURN to accept the default volume label, 
VMSRLS5, or you can enter a volume label of your choice. The volume 
label can be 1 to 12 characters long; spaces are not allowed. For example: 
If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 


Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12-characters in length. If you 
wish to use the default name of VMSRL5 just press RETURN in response to 
the next question. 


Enter the volume label for this system disk (no spaces) [VMSRL5]: SYSDSK 


The procedure asks which drive holds the distribution disk. Enter 
the device name of the RLO2 drive in the following format and press 
RETURN: 


Enter the name of the drive holding the distribution media (DDCU): DQcu 


Substitute the controller designation of the RLO2 disk drive for c and the 
unit number for u. For example: 


Enter the name of the drive holding the distribution media (DDCU): pQao 


During the next 30 minutes the procedure displays the following 
messages: 


“%MOUNT-I-MOUNTED, VMSO50 mounted on _DQAO: 

Restoring LIBRARY saveset. 

Y%BACKUP-I-STARTVERIFY, starting verification pass 
%BACKUP-I-RESUME, resuming operations on volume 3 
%BACKUP-I-READYREAD, mount volume 3 on _DQcu: for reading 
Enter "YES" when ready: 
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9 Spin down the RLO2 drive and remove the VMS V5.0 LIBRARY RLO2 
#2 disk. Place the disk labeled VMS V5.0 LIBRARY RLO2 #3 in the 
drive. Spin up the RLO2 drive. When the READY light turns on, type 
Y (for YES) and press RETURN. The optional save set is transferred to 
the system disk. This takes approximately 15 minutes. The procedure 
displays the following messages: 


“%BACKUP-I-STARTVERIFY, starting verification pass 
“%BACKUP-W-INCFILATR, incomplete file attribute data... 


Restoring OPTIONAL saveset. 
%BACKUP-I-STARTVERIFY, starting verification pass 


Creating [VMS$COMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 
PAGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


Will this node be a cluster member? (Y/N) 

10 Type N (for NO) and press RETURN. 

11 The procedure displays the following message: 
You may now remove the distribution kit from _$DQA0: 
Remove the distribution disk from the drive. 


12 The procedure asks you for new passwords for the SYSTEM, SYSTEST, 
and FIELD accounts. Passwords must be at least eight characters in 


length; they do not appear on the display. Press RETURN after you enter 


each one. After you enter the passwords, the procedure checks each 
one to make sure it meets the requirements for a good password. For 
example: 


Now we will ask you for new passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


Enter new password for account SYSTEM: PANCAKES 
Re-enter the password for account SYSTEM for verification: PANCAKES 


%UAF-I-MDFYMSG, user record(s) updated 


Enter new password for account SYSTEST: BRATWURST 
Re-enter the password for account SYSTEST for verification: BRATWURST 


ZUAF-I-MDFYMSG, user record(s) updated 


Enter new password for account FIELD: ZIRHUMBA 
Re-enter new password for account FIELD for verification: ZIRHUMBA 


%UAF-I-MDFYMSG, user record(s) updated 


The procedure will now check and verify passwords for the 
following accounts: 


SYSTEM, SYSTEST, FIELD 


Passwords that can be guessed easily will not be accepted. 


If the procedure verifies the passwords, it displays the following 
messages: 


%VMS-I-PWD_OKAY, account password for SYSTEM verified 
%NMS-I-PWD_OKAY, account password for SYSTEST verified 
%VMS-I-PWD_OKAY, account password for FIELD verified 
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If you enter a password incorrectly or if the password is too easy to guess, 
the procedure displays error messages similar to the following: 


YVMS-W-PWD_INVALID, account password for SYSTEM is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N (for 
NO) and press RETURN. When the procedure asks if you want to enter 

a new password, type Y (for YES) and press RETURN. Then enter a new 
password. For example: 


Do you want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEM account. The 
password you select must be at least 8 characters in length and may not 
be the same as the name of the account. 


New password: WILLIWAW 
Verification: WILLIWAW 


“UAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_SET, primary password for account SYSTEM set 


After you have entered the passwords, the procedure creates your 
RIGHTS database and displays the following message: 


Creating RIGHTS database file. SYS$SYSTEM:RIGHTSLIST.DAT 
Ignore any "%SYSTEM-F-DUPIDENT, duplicate identifier" errors 


After the procedure creates the RIGHTS database, go to Section 7.6 to 
install the mandatory update. 





7.6 Installing the Mandatory Update and Running AUTOGEN 


Follow the directions in this section to install the mandatory update and run 
AUTOGEN. AUTOGEN evaluates your hardware configuration and estimates 
typical workloads. It then sets system parameters, the sizes of the page, swap, 
and dump files, and the contents of VMSIMAGES.DAT. When AUTOGEN 
finishes, the installation procedure is complete. 


1 


After the procedure creates the RIGHTS database, it displays the 
following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


- DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of the system 
libraries are shipped in a data compressed format. If you have enough disk 
space, you may decompress them for faster access. Use SYS$UPDATE: LIBDECOMP .COM 
to data expand the libraries. If you choose not to decompress these libraries 
there will be a negative impact on the performance of the HELP and LINK 
commands . 


- BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX processor. 


Continuing with VAX/VMS V5.0 Installation Procedure. 


Configuring all devices on the system. 
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You must now install the MANDATORY UPDATE, which can be found 
on a separate distribution volume. 


VAX/VMS Software Product Installation Procedure V5.0 


It is 31-DEC-1988 at 15:00 
Enter a question mark (?) at any time for help. 


The procedure asks you for the device name of the drive that contains the 
mandatory update. Enter the following and press RETURN: 


*Where will the distribution volumes be mounted: CSAIi 
The procedure displays the following messages: 
%DCL-I_ALLOC, _CSA1: allocated 


Please mount the first volume of the set on CSAi:. 
*Are you ready? 


Place the tape cassette labeled VAX/VMS V5.0 BIN TU58 MANDATORY 
UPDATE in the CSA1 drive. When you are ready to continue, type Y and 
press RETURN. The procedure displays the following series of messages 
and asks if you want to purge files: 


“#MOUNT-I-MOUNTED, VMSMUP mounted on _CSA1: 
The following products will be processed: 
VMSMUP V5.0 
Beginning installation of VMSMUP V5.0 at 15:00 
“7VMSINSTAL-I-RESTORE, Restoring product saveset A... 
Installing VMS V5 mandatory update 
Do you want to purge files replaced by this installation [YES]? 
Press RETURN (for YES) and go to the next step. 


Depending on the version of the VMS operating system that you 
are installing, the mandatory update procedure might ask for certain 
information. Read the screen displays for instructions. 


If there is more than one TU58 tape cassette containing the mandatory 
update, you will be asked to change tape cassettes at some point during 
the procedure. When the procedure is finished, it displays the following 
message: 


VMSINSTAL procedure done at 15:00 
AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 
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Note: 


After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After the system shuts down, the procedure reboots the system if there 
is a default boot command procedure for the system disk on the console 
TU58. If the system does not reboot automatically, enter the BOOT 
command in the following format and press RETURN: 


>>> B DQu 


Substitute the unit number of the R80 drive for u. For example, suppose 
the R80 system disk has a unit number of one. Enter the following 
command and press RETURN: 


>>> B DQ1 


After the system reboots, the procedure displays the following message: 


The procedure might display warning messages that the VMS 
license must be registered. Be sure to register this license when 
the installation procedure finishes, as described in Chapter 8. 


VAX/VMS Version V5.0 Major version id = 01 Minor version id = 00 


You have successfully installed the VMS operating systen. 
The system is now executing the STARTUP procedure. 

Please await the completion of STARTUP before logging 
into the system (approximately three minutes) . 


WLI ~=OPCOM 31-DEC-1988 15:00.00.00 LUAAREALELL 
Logfile has been initialized by operator _OPAQO: 
Logfile is SYS$SYSROOT : [SYSMGR] OPERATOR . LOG; 1) 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 


Startup processing continuing... 


4SET-I-INTSET, login interactive limit=64, current interactive value = 0 
31-DEC-1988 15:00:00.00 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 
Accounting information: 

Buffered I/O count: 859 Peak working set size: 565 
Direct I/O count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: 0 
Charged CPU time: 0 00:00:55.23 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 
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Welcome to VAX/VMS V5.0 


USERNAME: SYSTEM 
PASSWORD: PANCAKES 


Welcome to VAX/VMS V5.0 


When you press RETURN, the VMS operating system prompt ($) is 
displayed. 


If you forget the password, follow the instructions for breaking into the 
system in the Guide to Setting Up a VMS System. 


10 There are several things you must do before you can use the system. For 
complete information, see Chapter 8. 
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After Installing VMS 


After you have installed the VMS operating system, you need to perform 
several important tasks to prepare the system for operation. This chapter tells 
you what the tasks are, whether they are optional or required, and the order 
in which you perform them. The following list summarizes the tasks that are 
described in this chapter: 


1 Registering your licenses—You must register the VMS licenses that came 
with the software. You must also register the licenses for any system 
integrated products that you purchased. 


2 Removing unwanted files from the system disk—You can free space on 
the system disk by removing the VMS files that you do not need. 


Note: If you have an RC25, RKO7, or RD52 system disk, you must follow the 


directions in Section 8.2. 


3 Customizing the system—There are several tasks you should perform to 
customize your system. 


4 Testing the system—Once you have customized the system, run the VMS 
User Environment Test Program (UETP) to test the system. 


5 Decompressing the system libraries—After you test the system you can 
decompress the system libraries. 


6 Backing up the system disk—To protect all the work you have just done, 
make a backup copy of the system disk. 





Registering Your Licenses 


The VMS license lets you use the VMS operating system. You must register 
this license. 


After you register the VMS license, you must register the licenses for any of 
the following system integrated products you have purchased: 


e VAxXclusters 
e DECnet-VAX 
¢ RMS Journaling 


* Volume Shadowing 


For step-by-step instructions on registering these licenses, see the current 
version of the VMS Release Notes. 
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8.2 Small System Disks 


Note: If you have an RC25, RKO7, or RD52 system disk, follow the directions in 


this section. 


On RC25, RKO7, and RD52 system disks there is not enough room for all 
the VMS operating system files and appropriately sized page and swap files. 
There also might not be enough room to run UETP (UETP needs at least 
1200 free blocks on the system disk). To free space on the system disk, use 
the following procedure. This procedure assumes that you have installed the 
VMS operating system and are logged into the SYSTEM account. 


1. To check the amount of free space on the system disk, enter the following 
command and press RETURN: 


$ SHOW DEVICE SYS$SYSDEVICE 


2 To free space on the system disk, use VMSTAILOR to remove any files 
that you do not need. Enter the following command and press RETURN: 


$ RUN SYS$UPDATE: VMSTAILOR 


The VMSTAILOR program asks if you want to tailor files ON or OFF. To 
remove files, type OFF and press RETURN. Then follow the directions 
that VMSTAILOR displays on the terminal screen. 


3 After you run VMSTAILOR, read Section 6.1.6 in the Guide to Setting Up 
a VMS System to determine and set the appropriate sizes for your page 
and swap files. After setting the sizes for your page and swap files, go to 
step 4. 


4 If there is enough room on the system disk, you can add files from the 
optional save set. Enter the following command and press RETURN: 


$ RUN SYS$UPDATE: VMSTAILOR 


The VMSTAILOR program asks if you want to tailor files ON or OFF. To 
add files, type ON and press RETURN. Then follow the directions that 
VMSTAILOR displays on the terminal! screen. 


8.3 Removing Unwanted Files with VMSTAILOR 


Read this section if you want to remove the VMS operating system files 

that you do not need from the system disk. For example, if you are not 
running DECnet-VAX, you do not need the network support files. You can 
remove unwanted files with the VMSTAILOR program. Log into the SYSTEM 
account, enter the following command and press RETURN: 


$ RUN SYS$UPDATE: VMSTAILOR 


The VMSTAILOR program asks you if you want to tailor files ON or OFF. 
Type OFF to remove unwanted files. 


The VMSTAILOR program lists each group of files and its size in blocks. Files 
are grouped according to their function. For example, all the files required 
for cluster support are in one group. A file group is made up of many small 
subgroups. You can eliminate an entire group of files, or you can eliminate 
one or more of its subgroups. 
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Decide which file groups or subgroups you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions that are 
easy to follow. 


VMSTAILOR displays the names of the files it deletes. After it finishes, 
AUTOGEN runs automatically to make the adjustments that are necessary 
after system files are deleted. 


Note: You can use VMSTAILOR at any time to delete or add groups of VMS 
files to the system disk. After adding files to the system disk, you should 
apply any updates that affect them. 


For example, suppose you do not need the VMS Version 5.0 MAIL utility 
and you run VMSTAILOR to remove those files. Later on, if you decide 
you want to use MAIL, you can run VMSTAILOR to return the MAIL 
files to the system disk. You then apply any VMS upgrade or update that 
has occurred since Version 5.0 that affected the MAIL utility. 





8.4 Customizing the System 


You must customize the system disk so that it automatically performs certain 
tasks when you boot. For instructions on customizing the system, read the 
following documentation (in the order given): 


1 Read Chapter 10 in this book. Follow the instructions for creating default 
boot command procedures. This chapter explains the different ways to 
boot the system. It also tells you how to shut down the system. 


2 Read the Guide to Setting Up a VMS System for instructions on customizing 
and using your system. You will find information on the following tasks: 


e Editing the template files SYCONFIG.COM, SYLOGICALS.COM, 
SYLOGIN.COM, and SYSTARTUP_V5.COM 


¢ Setting up user accounts 


* Adjusting system parameters 


8.5 Testing the System with UETP 


You must run the User Environment Test Package (UETP) to verify the 
installation. For complete information, see Chapter 9. Note that UETP needs 
at least 1200 free blocks on the system disk. If you have a small system disk 
such as an RC25, RKO7, or RD52, make sure you run VMSTAILOR to free 
enough space on the system disk before you try to run UETP. 
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8.6 Decompressing the System Libraries 





Decompressing the system libraries gives the system faster access to the 
libraries. The decompressed libraries require approximately 5000 additional 
blocks of disk space. To find out how much disk space you have, enter the 
following command and press RETURN: 


$ SHOW DEVICE SYS$SYSDEVICE 


If you have enough room on the disk, you can decompress the libraries. 
The decompression process takes approximately a half hour. Log into the 
SYSTEM account. Enter the following command and press RETURN: 


$ @SYS$UPDATE: LIBDECOMP .COM 


8.7 Backing Up the System Disk 
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Now that you have spent a lot of time and effort customizing and testing 
the system, protect your work by making a backup copy of the system disk. 
DIGITAL recommends that you perform the following operations: 


¢ Make a standalone backup kit 

° Back up the system disk 

e Back up the console TU58 

For complete information on these operations, see Chapter 11. Once you 


have backed up the system disk, install any software products that you have 
purchased. Follow the directions given in the software product manuals. 
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Running UETP 


The User Environment Test Package (UETP) is a VMS software package 
designed to test whether the VMS operating system is installed correctly. 
UETP puts the system through a series of tests that simulate a typical user 
environment, making demands on the system that are similar to demands 
that might occur in everyday use. 


UETP is not a diagnostic program; it does not attempt to test every feature 
exhaustively. When UETP runs to completion without encountering 
nonrecoverable errors, the system being tested is ready for use. 


UETP exercises devices and functions that are common to all VMS systems, 
with the exception of optional features such as high-level language compilers. 
The system components tested include the following: 


¢ Most standard peripheral devices 
e The system’s multiuser capability 
e DECnet-VAX 


e  Clusterwide file access and locks 


Summary of UETP Operating Instructions 


This section summarizes the procedure for running all phases of UETP with 
default values. If you are familiar with the test package, refer to this section. 
If you need further information, refer to Section 9.2. 


1 Log into the SYSTEST account as follows: 


Username: SYSTEST 
Password: 


Note: Because the SYSTEST and SYSTEST_CLIG accounts have privileges, 


unauthorized use of these accounts might compromise the security of 
your system. 


2 Make sure no user programs are running or user volumes are mounted. 
By design, UETP assumes and requests the exclusive use of system 
resources. Unpredictable results could occur if you ignore this restriction. 


3 After you log in, check all devices to be sure that the following conditions 
exist: 


e All devices you want to test are powered up and are on line to the 
system. 


e Scratch disks are mounted and initialized. 


¢ Disks contain a directory named [SYSTEST] with OWNER_UIC=[1,7]. 
(You can create this directory with the DCL command CREATE 
/DIRECTORY.) 


Running UETP 
9.1 Summary of UETP Operating Instructions 


Note: 


© Magnetic tape drives that you want to test contain a magnetic tape 
reel with at least 600 feet of tape. The magnetic tape is initialized 
with the label UETP (using the DCL command INITIALIZE). You 
should also mount the magnetic tape to make it available to the 
system. 


¢ Scratch tape cartridges have been inserted in each drive you want to 
test and are mounted and initialized with the label UETP. 


e Line printers and hardcopy terminals have plenty of paper. 


*® Terminal characteristics and baud rate are set correctly (see the user’s 
guide for your terminal). 


Note that some communications devices need to be set up by DIGITAL 
Field Service (see Section 9.3). 


If you encounter any problems in preparing to run UETP, read Section 9.3 
before proceeding. 


To start UETP, enter the following command and press RETURN: 
$ QUETP 

UETP responds with the following question: 

Run "ALL" UETP phases or a "SUBSET" [ALL]? 


Press RETURN to choose the default response enclosed in brackets. 
UETP responds with three more questions in the following sequence: 


How many passes of UETP do you wish to run [1]? 
How many simulated user loads do you want [n]? 
Do you want Long or Short report format [Long]? 


Press RETURN after each prompt. After you answer the last question, 
UETP initiates its entire sequence of tests, which run to completion 
without further input. The final message should look like the following: 


DE He 2 ee Ae 2 Fe Oe Ae HA He OE 2 EE A 2 Ae 2 2 Ae ee 2 fe 2k he 2 ie 2h 2 ie 2 2c oe ie 2 ie ee 2 2 2 2 2 2 2k 
* * 


END OF UETP PASS 1 AT 31-DEC-1988 16:30:09.38 
* * 
FAA AGG GCS IGRI ICICI CII CAC I aC ICI GE 4 ak 2k 24 2k 2k 


After UETP runs, check the log files for errors. If testing completes 
successfully, the VMS operating system is in proper working order. 


After a run of UETP, you should always run the Error Log Utility to 
check for hardware problems that can occur during a run of UETP. For 
information on running the Error Log Utility, refer to the VMS Error 
Log Utility Manual. 


If VETP does not complete successfully, refer to Section 9.5. 


If you want to run UETP without using the default responses, refer to 
Sections 9.4 through 9.4.4, which explain the options. 
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9.2 Logging In 


Obtain the SYSTEST password from your system manager. Log into the 
SYSTEST account from the console terminal as follows: 


Username: SYSTEST 
Password: 


Note: Because SYSTEST has privileges, unauthorized use of this account might 
compromise the security of your system. 


UETP will fail if you do not run the test from the SYSTEST account. Also, 
if you try to run UETP from a terminal other than the console terminal, the 
device test phase displays an error message stating that the terminal you are 
using is unavailable for testing. You can ignore this message. 


After you log into the SYSTEST account, enter the command SHOW USERS 
to make sure no user programs are running and no user volumes are 
mounted. UETP requires exclusive use of system resources. If you ignore 
this restriction, UETP may interfere with applications that depend on these 
resources. 


9.2.1 SYSTEST Directories 


If you logged in successfully, you should be in the root directory [SYSTEST] 
on the system disk. UETP uses directories named [SYSTEST] to hold all the 
files used by UETP command procedure (UETP.COM) and temporary files 
used by UETP during testing. 


The DCL command SHOW LOGICAL displays the translation of the logical 
name SYS$TEST on a typical system: 


$ SHOW LOGICAL SYS$TEST 
"“SYS$TEST" = "SYS$SYSROOT: [SYSTEST]" (LNM$SYSTEM_TABLE) 


If you want UETP to test a particular disk, such as a scratch disk, create 
either a [SYSTEST] directory or a [SYSO.SYSTEST] directory on that disk. 
Section 9.3.2 discusses setting up scratch disks for testing. 


9.3 Setting Up for UETP 


After you log in, you need to set up the devices on the system for UETP 
testing. 

Note: Your system may not have all the devices described in this section. 
You should check all devices to be sure that the following conditions exist: 
e All devices you want to test are turned on and are on line. 
* Scratch disks are mounted and initialized. 


e Disks contain a directory named [SYSTEST] with OWNER_UIC=[1,7]. 
Use the CREATE/DIRECTORY command if the [SYSTEST] directory does 
not exist on the disk. 


e Scratch magnetic tape reels are physically mounted on each drive you 
want tested and are initialized with the label UETP (using the DCL 
command INITIALIZE). Make sure magnetic tape reels contain at least 
600 feet of tape. 
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© Scratch tape cartridges have been inserted in each drive you want to test 
and are mounted and initialized with the label UETP. 


¢ Line printers and hardcopy terminals have plenty of paper. 


¢ Terminal characteristics and baud rate are set correctly (see the user’s 
guide for your terminal). 


Note that some communications devices discussed in this section need to be 
set up by DIGITAL Field Service. 


9.3.1 Setting Up the System Disk 


Before running UETP, make sure that the system disk has at least 1200 
blocks available. Note that large systems, such as systems that run more than 
20 load test processes, might require a minimum of 2000 available blocks. 
Running multiple passes of UETP causes log files to accumulate in the default 
directory, further reducing the amount of disk space available for subsequent 
passes. 


If disk quotas are enabled on the system disk, you should disable them before 
you run UETP. 


9.3.2 Setting Up Additional Disks 
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The disk test uses most of the available free space on each testable disk. 
UETP estimates the space that the disk test uses for normal testing as follows: 


¢ On each testable disk, the device test phase tries to create two files. The 
size of these files depends on how much free space is available on the 
disk. Usually the test creates each file with 5% of the free space on the 
disk. However, if the disk is nearly full, the test creates files that are 5 
blocks. If the test cannot create 5 block files, it fails. Only the initial file 
creation can cause the device test to fail because of lack of disk space. 


e The test randomly reads and writes blocks of data to the files. After every 
multiple of 20 writes for each file, the test tries to extend the file. The 
size of this extension is either 5% of the free disk space, or 5 blocks if the 
file was created with 5 blocks. This process of extension continues until 
the combined space of the files reaches 75% of the free disk space. 


By creating and extending fragmented files in this way, UETP exercises the 
disk. This allows the test to check for exceeded quotas or a full disk, and to 
adjust for the amount of available disk space. 


To prepare each disk drive in the system for UETP testing, use the following 
procedure: 


1 Place a scratch disk in the drive and spin up the drive. If a scratch disk 
is not available, use any disk with a substantial amount of free space; 
UETP does not overwrite existing files on any volume. If your scratch 
disk contains files that you want to keep, do not initialize the disk; go to 
step 3. 


2 If the disk does not contain files you want to save, initialize it. For 
example: 


$ INITIALIZE DUA1: TEST1 
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This command initializes DUA1, and assigns the volume label TEST1 to 
the disk. All volumes must have unique labels. 


Mount the disk. For example: 
$ MOUNT/SYSTEM DUA1: TEST1 


This command mounts the volume labeled TEST1 on DUA1. The 
/SYSTEM qualifier indicates that you are making the volume available to 
all users on the system. 


UETP uses the [SYSTEST] directory when testing the disk. If the volume 
does not contain the directory [SYSTEST], you must create it. For 
example: 


$ CREATE/DIRECTORY/OWNER_UIC=(1,7] DUA1: [SYSTEST] 


This command creates a [SYSTEST] directory on DUA1 and assigns a user 
identification code (UIC) of [1,7]. The directory must have a UIC of [1,7] 
to run UETP. 


If the disk you have mounted contains a root directory structure, you can 
create the [SYSTEST] directory in the [SYS0.] tree. 


9.3.3. Setting Up Magnetic Tape Drives 


To set up each magnetic tape drive in the system, use the following 


procedure: 

1. Place a scratch volume with at least 600 feet of magnetic tape in the tape 
drive. Make sure that the write-enable ring is in place. 

2 Position the magnetic tape at the beginning-of-tape (BOT) and put the 
drive on line. 

3 Initialize each scratch magnetic tape with the label UETP. For example, if 


you have mounted a scratch magnetic tape on MTA1, enter the following 
command and press RETURN: 


¢ INITIALIZE MTA1: UETP 


Magnetic tapes must be labeled UETP to be tested. 


If you encounter a problem initializing the magnetic tape, or if the test 
has a problem accessing the magnetic tape, refer to the description of the 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.4 Setting Up Tape Cartridge Drives 


To set up tape cartridge drives that you want to test, use the following 
procedure: 


1 
2 


Insert a scratch tape cartridge in the tape cartridge drive. 
Initialize the tape cartridge. For example: 


¢ INITIALIZE MUAO: UETP 


Tape cartridges must be labeled UETP to be tested. 
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If you encounter a problem initializing the tape cartridge, or if the test has 
a problem accessing the tape cartridge, refer to the description of the DCL 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.5 Setting Up Terminals and Line Printers 


Terminals and line printers must be turned on to be tested by UETP. They 
must also be on line. Check that line printers and hardcopy terminals have 
enough paper. The amount of paper required depends on the number of 
UETP passes that you plan to execute. Each pass requires two pages for each 
line printer and hardcopy terminal. 


Check that all terminals are set to the correct baud rate and are assigned 
appropriate characteristics (see the user’s guide for your terminal). 


Spooled devices and devices allocated to queues fail the initialization phase 
of UETP and are not tested. 


9.3.6 Preparing Ethernet Adapters for UETP Testing 


Note: 


Make sure that no other processes are sharing the device when you run 
UETP. 


If your system is part of a local area VAXcluster, you will not be able 
to test your Ethernet adapter because you need the Ethernet adapter to 
maintain your cluster connection. 


UETP automatically shuts down DECnet and the LAT-11 server for the 
duration of the device tests and restarts them when the device tests are 
completed. You must shut down any local applications. 


9.3.7 Preparing the DR11—W for UETP Testing 


Note: Only DIGITAL Field Service personnel should set up the DR11-W for 


UVETP testing. 


The DR11-W uses an internal logical loopback mode that tests all 
functionality except that of module connectors, cables, and transceivers. 
Because random external patterns are generated during this operation, the 
user device or other processor might need to be isolated from the DR11-W 
being tested until the testing is complete. 


To test the DR11-—W properly, the E105 switchpack must be set as follows: 
Switch 1 Switch 2 Switch 3 Switch 4 Switch 5 
Off On Off Off On 


When UETP testing is completed, restore the DR11-W to the proper operating 
configuration. 
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9.3.8 Preparing the DRV11—WA for UETP Testing 


Note: Only DIGITAL Field Service personnel should set up the DRV11-WA for 
UETP testing. 


To prepare the DRV11-WA on a MicroVAX for UETP testing, make sure the 
following conditions exist: 


e The jumpers on the DRV-11WA board are set to W2, W3, and W6. 
¢ A loop-back cable is connected to the DRV11—-WA board. 


e The DRV-11WA board is in a slot from 8 to 12. If the DRV11-WA is in a 
slot other that 8 to 12, you might get timeout errors. 


When UETP testing is completed, restore the DRV11-—WA to the proper 
operating configuration. 


9.3.9 Preparing the DR750 or the DR780 for UETP Testing 


Note: Only DIGITAL Field Service personnel should set up the DR750 or DR780 
for UETP testing. 


To prepare the DR750 or the DR780 for UETP testing, use the following 
procedure: 


1 Copy the DR780 microcode file, XF780.ULD, from the diagnostic medium 
to SYS$SYSTEM. Use the procedure described in the documentation 
provided with the DR780 Microcode Kit. 


2 Turn off the power to the DR780. 

3 Make the following DR780 backplane jumper changes: 
¢ Remove the jumper from W7 and W8. 
e Add a jumper from E04M1 to E04R1. 
e Add a jumper from E04M2 to E04R2. 


4 Disconnect the DDI cable from the DR780. This cable is either a 
BCO6V-nn cable, which can be disconnected, or a BCO6R-nn cable, 
which requires that you remove its paddle card from the backplane of the 
DR780. 


5 Restore power to the DR780. 


When UETFP testing is completed, restore the DR750 or the DR780 to the 
proper operating configuration. 


9.3.10 Preparing the MA780 for UETP Testing 


Make sure that the MA780 is set up according to the guidelines for shared 
memory in the Guide to Maintaining a VMS System. 


If you run the MA780 device test individually, the logical name CTRLNAME 
must be defined as MPM, regardless of the memory name. As an alternative, 
you can enter “MPM” in response to the controller designation prompt. 
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9.3.11 Preparing a Second LPA11—K for UETP Testing 


If you have two LPA11-Ks, be sure that each is given a systemwide logical 
name in the SYS$MANAGER:LPA11STRT.COM file. The logical name for 
the first LPA11-K should be LPA11$0, and the logical name for the second 
LPA11-K should be LPA11$1. 


9.3.12 Devices Not Tested 


UETP does not test the following devices; their status has no effect on UETP 
execution: 


e Devices that require operator interaction (such as card readers) 


¢ Software devices (such as the null device and local memory mailboxes) 


UETP does not have specific tests for UDA, HSC, or CI devices; they are 
tested implicitly by the disk, magnetic tape, and DECnet tests. 


UETP also does not test the console terminal or console drives. If you boot 
the system, log in, and start UETP, you have shown that these devices can be 
used. 


9.3.13 Preparing for VAXcluster Testing 
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Before you run VETP in a VAXcluster environment, you should check the 
SYSTEST_CLIG account. The SYSTEST_CLIG account parallels SYSTEST 
except that it is dedicated to running the cluster-integration test. The 
requirements for the SYSTEST_CLIG account are as follows: 


1 The account should be present in the user authorization file, exactly as 
distributed by DIGITAL on each system in your VAXcluster. 


Note: You may have disabled the SYSTEST_CLIG account as part of the 


VMS Version 5.0 upgrade procedure. If you did, you should reenable 
the SYSTEST_CLIG account before you run UETP. 


To reenable the SYSTEST_CLIG account, enter the following commands 
and press RETURN after each one: 


$ SET DEFAULT SYS$SYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=NODISUSER SYSTEST_CLIG 
UAF> EXIT 


2 The account should have a null password. 


Note: You may have supplied a password for the SYSTEST_CLIG account 


as part of the VMS Version 5.0 upgrade procedure. If you did, you 
should set the password to the null password before you run UETP. 


To set the password of the SYSTEST_CLIG account to the null password, 
enter the following commands and press RETURN after each one: 
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$ SET DEFAULT SYS$SYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /NOPASSWORD SYSTEST_CLIG 
UAF> EXIT 

$ 


Note: DIGITAL recommends that you disable the SYSTEST_CLIG account 
after testing has completed. 


To disable the SYSTEST_CLIG account, enter the following commands 
and press RETURN after each one: 


$ SET DEFAULT SYS$SYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=DISUSER SYSTEST_CLIG 
UAF> EXIT 


3 The privileges and quotas of the SYSTEST_CLIG account should match 
those of the SYSTEST account. 


UETP requires little additional preparation for the cluster-integration test 
phase beyond the requirements for other UETP test phases. The additional 
requirements for cluster integration testing are as follows: 


1 Your system must be a member of a VAXcluster. If it is not, UETP 
displays a message and does not attempt to run the test. 


2 Your system must use the same deadlock detection interval as the other 
systems in the VAXcluster. 


3 The files UETCLIGOO.COM and UETCLIGO0.EXE, located in SYS$TEST, 
are necessary for each system included in the test. 


4 DECnet must be set up between the VAXcluster nodes; UETP uses 
DECnet to create a process on those nodes. All checks that the test makes 
depend on its ability to create the SYSTEST_CLIG processes and to 
communicate with them using DECnet. 


5 There must be a [SYSTEST] or [SYSO.SYSTEST] directory on some disk 
available to the VAXcluster for each node (both VMS and HSC) in the 
cluster. The test uses the same directory as the UETP disk test to create a 
file on each cluster node and to see if some other VMS node in the cluster 
can share access to that file. There must be one such directory per node; 
the test continues with the next cluster node once it has finished with a 
file. 


9.3.14 Preparing a Small-Disk System 
You have a small-disk system if your system disk is an RKO7, RD52, or RC25. 


After you install the VMS operating system on a small-disk system, you may 
not have the 1200 blocks of free disk space required to run UETP successfully. 
If you do not have 1200 free blocks on your system disk, use VMSTAILOR 
before you run UETP. For instructions on using VMSTAILOR, see Chapter 8. 
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9.3.15 Preparing DECnet 


9.4 


Starting UETP 
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The DECnet phase of UETP uses more system resources than most. Before 
you start UETP, you can choose which remote node you want the DECnet 
phase of the test to run from. By specifying the least busy node to run the 
DECnet test from, you can minimize disruption to remote system users, 


By default, the file UETDNET00.COM chooses the node to run the DECnet 
test from. If you want to choose the node to run the DECnet test on, enter 
the following command before you invoke UETP: 


$ DEFINE/GROUP UETP$NODE_ADDRESS node_address 


This command equates the group logical name UETP$NODE_ADDRESS to 
the node address of the node in your area on which you want to run the 
DECnet phase of UETP. 


For example: 


$ DEFINE/GROUP UETP$NODE_ADDRESS 2.121 


When you run UETP, a router node attempts to establish a connection 
between your node and the node defined by UETP$NODE_ADDRESS. 
Occasionally the connection between your node and the router node might be 
busy or non-existent. When this happens, the system displays the following 
error messages: 


YNCP-F-CONNEC, Unable to connect to listener 
-~SYSTEM-F-REMRSRC, resources at the remote node were insufficient 


YNCP-F-CONNEC, Unable to connect to listener 
-SYSTEM-F-NOSUCHNODE, remote node is unknown 





When you have logged in and prepared the system and devices, you are 
ready to begin the test. 


To start UETP, enter the following command and press RETURN: 
$ QUETP 

UETP displays the following prompt: 

Run "ALL" UETP phases or a "SUBSET" [ALL]? 


Throughout the startup dialog, brackets indicate the default value, which you 
can choose by pressing RETURN. 


When running UETP for the first time, it is a good idea to choose the default 
value (ALL) and run all the phases. If you choose ALL, UETP displays three 
more questions, which are described in Sections 9.4.2 through 9.4.4. If you 
want to run all the test phases, skip the next section. 


Running UETP 
9.4 Starting UETP 


9.4.1 Running a Subset of Phases 


You can run a single phase by entering SUBSET or S in response to the 
following prompt: 


Run "ALL" UETP phases or a "SUBSET" [ALL]? 
UETP prompts you for the phase you want to run as follows: 


You can choose one or more of the following phases: 
DEVICE, LOAD, DECNET, CLUSTER 
Phase (s): 


There is no default; enter one or more phase names from the list. Separate 
two or more phases with spaces or commas. 


If your choice includes the LOAD phase, UETP displays the three prompts 
described in the next sections. To run the LOAD phase, refer to the next 
section. 


If you exclude the LOAD phase, UETP responds with only two prompts: 


How many passes of UETP do you wish to run [1]? 
Do you want Long or Short report format [Long]? 


Sections 9.4.2 and 9.4.4 discuss these questions. After you answer both 
questions, the phase you have selected runs to completion. 


9.4.2 Single Run Versus Multiple Passes 


If you specified the default ALL or a subset of phases at the last prompt, 
UETP displays the following message: 


How many passes of UETP do you wish to run [1]? 


You can repeat the test run as many times as you want. If you enter 1 in 
response to the prompt (or press RETURN for the default), UETP stops 
after completing a single run. If you specify a number greater than 1, UETP 
restarts itself continuously until it completes the number of passes (runs) 
specified. 


You can run UETP once to check that the system is working, or many times 
to evaluate the system’s response to continuous use. For example, a field 
service technician who is interested only in verifying that a newly installed 
system works might run UETP once or twice. A manufacturing technician 
might let the system run for several hours as part of the system integration 
and test. 


When you specify multiple UETP runs, you might want to request a short 
console log (see Section 9.4.4). Make certain that all line printers and 
hardcopy terminals have enough paper; each run requires two pages. 
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9.4.3. Defining User Load for Load Test 


Note: 


After you specify the number of passes, UETP prompts you as follows: 


How many simulated user loads do you want [n]? 


UETP displays this prompt only if you choose to run the LOAD phase, 
either implicitly (by running all phases), or explicitly (by running a subset 
and specifying the LOAD phase). 


The purpose of the load test is to simulate a situation in which a number of 
users (detached processes) are competing for system resources. In response 
to this prompt, enter the number of users you want to simulate for this test. 
The number in brackets is the default value that UETP computed for your 
system. The default value depends on the amount of memory and the paging 
and swapping space that your system has. 


Although the given default value is the best choice, you can increase or 
decrease the user load by entering your own response to the prompt. 
However, be aware that an increase might cause the test to fail because 
of insufficient resources. 


If you want to see UETP display the user load equation as it runs, see 
Section 9.5.2. 


9.4.4 Long and Short Report Format 
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The following prompt allows you to choose one of two console report 
formats: 


Do you want Long or Short report format [Long]? 


If you choose the long report format (the default), UETP sends all error 
messages as well as information on the beginning and end of all phases and 
tests to the console terminal. UETP records all its output in the UETP.LOG 
file, regardless of your response to this question. 


In many cases, it may not be convenient to have UETP write the bulk of 

its output to the terminal. For example, if you run UETP from a hardcopy 
terminal, the printing of all the output can slow the progress of the tests. This 
delay may not be a problem if you have requested only one run; however 
you may prefer to use the short format if you intend to run multiple passes of 
UVETP from a hardcopy terminal. 


If you request the short format, UETP displays status information at the 
console, such as error messages and notifications of the beginning and end 
of each phase. This information enables you to determine whether UETP 
is proceeding normally. If the short console log indicates a problem, you 
can look at UETP.LOG for further information. UETP.LOG contains all the 
output generated by the various phases, as well as the status information 
displayed at the console. 


After you choose the report format, UETP initiates its sequence of tests 
and runs to completion. If UETP does not complete successfully, refer to 
Section 9.5 for troubleshooting information. 
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9.4.5 Termination of UETP 


9.4.5.1 


At the end of a UETP pass, the master command procedure UETP.COM 
displays the time at which the pass ended. In addition, UETP.COM 
determines whether UETP needs to be restarted. (You can request multiple 
passes when you start up the test package; see Section 9.4.2.) 


At the end of an entire UETP run, UETP.COM deletes temporary files and 
does other cleanup activities. 


Pressing CTRL/Y or CTRL/C lets you terminate a UETP run before it 
completes normally. Normal completion of a UETP run, however, includes 
the deletion of miscellaneous files that have been created by UETP for the 
purpose of testing. The use of CTRL/Y or CTRL/C might interrupt or prevent 
these cleanup procedures. 


The effect of these control characters depends on what part of UETP you 
are executing. For an explanation of the organization of UETP and its 
components, refer to Section 9.6. 


Using CTRL/Y 
Press CTRL/Y to abort a UETP run. Note, however, that cleanup of files and 
network processes in the [SYSTEST] directory may not be complete. 


If you are running an individual test image, pressing CTRL/Y interrupts the 
current UETP test and temporarily returns control to the command interpreter. 
While the test is interrupted, you can enter a subset of DCL commands that 
are executed within the command interpreter and do not cause the current 
image to exit. The VMS DCL Concepts Manual contains a table of commands 
that you can use within the command interpreter. In addition, you can enter 
any of the following commands: 


¢ The CONTINUE command continues the test from the point of 
interruption (except during execution of the cluster test). 


® The STOP command terminates the test; the test aborts and control 
returns to the command interpreter. 


Note: Using the STOP command may prevent cleanup procedures from 


executing normally. You should use the EXIT command if you want 
the image to do cleanup procedures before terminating. 


¢ The EXIT command does cleanup procedures and terminates the test 
(except during execution of the cluster test); control returns to the 
command interpreter. 


If you enter any DCL command other than CONTINUE, STOP and EXIT, 


the test does cleanup procedures and terminates, and the DCL command 
executes. 
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9.4.5.2 


Using CTRL/C 

Press CTRL/C to interrupt a UETP run. You cannot continue the same test 
phase after you press CTRL/C. UETP automatically goes to the next phase in 
the master command procedure. 


Some UETP phases react to CTRL/C by cleaning up all activity and 
terminating immediately. Such tests display the following message: 


ZUETP-I-ABORTC, 'testname' to abort this test, type “C 


The phases that do not display the previous message terminate all processes 
they have started. These processes might not have a chance to complete 
normal cleanup procedures. 


If you are running an individual test image, however, you can use CTRL/C 
to terminate the execution of the image and complete cleanup procedures. 


Note that CTRL/C does not complete cleanup procedures for the cluster test. 





9.5 Troubleshooting 


This section explains the role of UETP in interpreting operational errors in 
a VMS operating system. Section 9.5.4 discusses common errors that can 
appear in a UETP run and describes how to correct them. 


9.5.1. Relationship of UETP to Error Logging and Diagnostics 
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When UETP encounters an error, it reacts like a user program. Either it 
returns an error message and continues, or it reports a fatal error and 
terminates the image or phase. In either case, UETP assumes that the 
VMS hardware is correctly installed and operating and does not attempt 
to diagnose the error. 


If the cause of an error is not readily apparent, use the following methods to 
diagnose the error: 


© VMS Error Log Utility—Run the Error Log Utility to obtain a detailed 
report of hardware and system errors. Error log reports provide 
information about the state of the hardware device and I/O request 
at the time of each error. For information about running the Error Log 
Utility, refer to the VMS Error Log Utility Manual. 


© Diagnostic facilities—Use the diagnostic facilities to test exhaustively a 
device or medium to isolate the source of the error. 
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9.5.2 Interpreting UETP Output 


You can monitor the progress of UETP tests at the terminal from which 
they were started. This terminal always displays status information, such as 
messages that announce the beginning and end of each phase and messages 
that signal an error. 


The tests send other types of output to various log files depending on 

how you started the tests. The log files contain output generated by the 
actual test procedures. Even if UETP completes successfully, with no errors 
displayed at the terminal, it is good practice to check these log files for errors. 
Furthermore, when errors are displayed at the terminal, check the log files for 
more information about their origin and nature. 


Each test returns a final completion status to the test controller image, 
UETPHAS00, using a termination mailbox. This completion status is an 
unsigned longword integer denoting a condition value. As a troubleshooting 
aid, UETPHASO0 displays the test’s final completion status using the $FAO 
and $GETMSG system services. Sometimes, however, the $FAO service 
needs additional information which cannot be provided using the termination 
mailbox. When this happens, UETP displays an error message similar to the 
following: 


UETP-E-ABORT, !AS aborted at !%D 


When UETP displays these types of error messages, check the log files for 
more information. You can also run the individual test to attempt to diagnose 
the problem. 


The error messages that appear at the terminal and within the log files have 
two basic sources: 


e UETP tests 


e System components that are tested 


To interpret the messages, you might need to refer either to the VMS System 
Messages and Recovery Procedures Reference Volume or to the manual that 
describes the individual system component. 


Several parts of UETP, such as some device tests, UETINITO0.EXE, 
UETCLIGO0.EXE, and UETDNET00.COM, let you obtain additional 
information concerning the progress of the test run or the problems it 
encounters. Because this information is usually insignificant, it is not 
displayed on the screen. To view the information, enter the following 
command and run the program: 


$ DEFINE MODE DUMP 


The following example shows the output for UETINIT00.EXE on a 
VAX 11/750: 


$ RUN UETINITOO 
Welcome to VAX/VMS UETP Version V5.0 
YUETP-I-ABORTC, UETINITOO to abort this test, type “C 


You are running on an 11/750 CPU with 8704 pages of memory. 
The system was booted from _DRAO: [SYSO.]. 
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9.5.2.1 


Run "ALL" UETP phases or a "SUBSET" [ALL]? 
How many passes of UETP do you wish to run [1]? 


The default number of loads is the minimum result of 


1) CPU_SCALE * ((MEM_FREE + MEM_MODIFY) / (WS_SIZE * PER_WS_INUSE) } 
0.80 * (( 8704 + 323) / ( 350 * 0.20)) = 103 


2) Free process slots = 56 


3) Free page file pages / Typical use of page file pages per process 
18040 / 1000 = 18 


How many simulated user loads do you want [18]? 
Do you want Long or Short report format [Long]? 


UETP starting at 31-DEC-1988 09:08:26.71 with parameters: 
DEVICE LOAD DECNET CLUSTER phases, i pass, 18 loads, long report. 
$ 


This program does not initiate any phase; it displays the equation used by 
UETP to determine user load and the specific factors that are employed in the 
current run. 


You should respond to the questions by pressing RETURN. After you respond 
to the first prompt, the program displays the expressions that determine the 
default number of simultaneous processes. The following definitions apply: 


¢ CPU_SCALE refers to the relative processing power of the CPU in 
relation to a VAX-11/780. For example, a VAX-11/785 has a 
CPU_SCALE of 1.5 because it has 1.5 times the processing power of a 
VAX-11/780 (1.0). 


¢ MEM-_ FREE represents memory in pages available to users. 
¢ MEM-—MODIPY represents memory pages on the modified page list. 
¢ WS_SIZE represents working set size. 


® PER_—WS_INUSE represents typical percentage of the working set in 
active use for each process. 


UETINITOO also displays the specific values represented by the expressions. 
In this example, UETP selects 18 as the default for simulated user loads, 
because 18 is the minimum result of the three expressions. 


You should deassign the logical name MODE before running UETP, unless 
you prefer to see the previous breakdown every time you run UETP. 


Defining a Remote Node for UETP Ethernet Testing 

When the UETUNAS0O0 test of the UETP executes, it is sometimes difficult to 
determine whether the problems it reports concern the device under test or 
the remote device. The easiest way to ensure that the test properly reports 
errors on the device under test is to define a “good turnaround.” A “good 
turnaround” is a remote node that you know turns around Ethernet packets 
correctly and is up and waiting in the ready state. 


You can make the UETUNASO0 test use a known “good turnaround” by 
performing the following actions. In the commands that follow, assume that 
the “good” device is on node BETA, and that node BETA is already defined in 
the network database. 
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1 Find the address of the “good” Ethernet node by using the Network 
Control Program (NCP). In order to use NCP, the following conditions 
must apply: 


¢ DECnet must be up and running on the system. 


¢ The account you are using must have TMPMBX and NETMBX 
privileges. 
Enter the following commands and press RETURN: 


¢ RUN SYS$SYSTEM: NCP 
Ncp> TELL BETA SHOW CHARACTERISTICS ACTIVE LINES 


If node BETA has not been defined in your network database, NCP 
displays an error message. In this event, specify another “good” node and 
retry the command. Otherwise, see your system or network manager. 


NCP displays information similar to the following: 


Active Line Volatile Characteristics as of 15-OCT-1986 16:13:02 
Line = UNA-0O 


Counter timer = 28800 

Receive buffers = 6 

Controller = normal 

Protocol = Ethernet 

Service timer = 4000 

Hardware address = AA-00-04-00-46-D3 
UNA device buffer size = 1498 


2 Use the displayed hardware address (in this case, AA00040046D3) to 
define the logical name TESTNIADR to point to the “good turnaround.” 
Note that you do not specify the hyphens (-). 


First, log in to the SYSTEST account. Then enter the following command: 
¢ DEFINE/SYSTEM TESTNIADR AA00040046D3 
3 Run UETP. 


4 When UETP has completed, deassign the logical name TESTNIADR by 
entering the following command: 


$ DEASSIGN/SYSTEM TESTNIADR 





9.5.3 TheLog Files 


At the end of a UETP run, the directory SYS$TEST contains a log file named 
UETP.LOG. This file contains all information generated by all UETP tests 
and phases. If the run involves multiple passes, you will find a version of 
UETP.LOG for each pass. 


Although UETP.LOG contains information from all the passes, only 
information from the latest run is stored in this file. Information from the 
previous run is stored in a file named OLDUETP.LOG, which also has a 
version for each pass. Using these two files, UETP provides the output from 
its tests and phases from the two most recent runs. 


The cluster test creates a NETSERVER.LOG file in SYS$TEST for each pass 
on each system included in the run. If the test is unable to report errors (for 
example, if the connection to another node is lost), the NETSERVER.LOG 
file on that node contains the result of the test run on that node. UETP does 
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not purge or delete NETSERVER.LOG files; therefore, you must delete them 
occasionally to recover disk space. 


If a UETP run does not complete normally, SYS$TEST might contain other 
log files. Ordinarily these log files are concatenated and placed within 
UETP.LOG. You can use any log files that appear on the system disk for 
error checking, but you must delete these log files before you run any new 
tests. You may delete these log files yourself or rerun the entire UETP, which 
checks for old UETP.LOG files and deletes them. 


9.5.4 Possible UETP Errors 
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This section is intended to help you identify and solve problems you might 
encounter running UETP. You should refer to this section if you need help 
understanding a system failure and isolating its cause. This section is not 
intended as a repair manual and is not expected to diagnose any flaws in 
your system. It should, however, help you to interpret and act upon the 
information in the error messages. 


If you are unable to correct an error after following the steps in this section, 
you should contact your DIGITAL Field Service representative. Any 
information you can supply about the measures you have taken to isolate 
the problem will help your DIGITAL Field Service representative diagnose the 
problem. 


The following are the most common failures encountered while running 
UETP: 


1 Wrong quotas, privileges, or account 
UETINITO1 failure 

Insufficient disk space 

Incorrect VAXcluster setup 

Problems during the load test 
DECnet error 

Errors logged but not displayed 

No PCB or swap slots 


oan oot W ND 


Hangs 
10 Bugchecks and machine checks 


The following sections describe these errors and offer the best course of action 
for dealing with each one. 
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9.5.4.1 


Note: 


Wrong Quotas, Privileges, or Account 

If your assigned quotas or privileges do not match standard quotas and 
privileges for the SYSTEST account, UETP displays the following error 
message: 


FO ACA IO AK AE 
* UETINITOO * 


* Error count = i * 
FOR II ROR A aR aR ok 


-UETP-W-TEXT, The following: 


OPER privilege, 
BIOLM quota, 
ENQLM quota, 
FILLM quota, 


are nonstandard for the SYSTEST account and may result in UETP errors. 


This message informs you that the OPER privilege and the BIOLM, ENQLM, 
and FILLM quotas are either not assigned correctly or are not assigned at all. 


UETP displays a similar message if you run the cluster integration test 
phase, and the privileges and quotas for the SYSTEST_CLIG account are 
incorrect. The SYSTEST and SYSTEST_CLIG accounts require the same 
privileges and quotas. Take the same action described in this section. 


Solution 
To correct the problem, use the following procedure: 


1 Display all privileges and quotas in effect for the current account using the 
DCL commands SHOW PROCESS/PRIVILEGE and SHOW PROCESS 
/QUOTA as follows: 


$ SHOW PROCESS/PRIVILEGES 
31-DEC-1988 18:06:02.89 OPAO: User : SYSTEST 


Process privileges : 


CMKRNL may change mode to kernel 

CMEXEC May change mode to exec 

SYSNAM may insert in system logical name table 
GRPNAM may insert in group logical name table 
DETACH may create detached processes 

DIAGNOSE may diagnose devices 

LOG_IO may do logical 1/0 

GROUP may affect other processes in same group 
PRMCEB may create permanent common event clusters 
PRMMBX may create permanent mailbox 

SETPRV may set any privilege bit 

TMPMBX may create temporary mailbox 

NETMBX may create network device 

VOLPRO may override volume protection 

PHY_10 may do physical I/O 

SYSPRV may access objects via system protection 


$ SHOW PROCESS/QUOTAS 
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31-DEC-1988 18:06:03.36 OPAO: User: SYSTEST 
Process Quotas: 


Account name: SYSTEST 


CPU limit: Infinite Direct I/O limit: 55 
Buffered I/O byte count quota: 32768 Buffered I/O limit: 18 
Timer queue entry quota: 20 Qpen file quota: 100 
Paging file quota: 19543 Subprocess quota: 8 
Default page fault cluster: 64 AST limit: 98 
Enqueue quota: 300 Shared file limit: i?) 
Max detached processes: 0 Max active jobs: i?) 


2 Check that the privileges and quotas assigned to the account match the 
following: 


Privileges 


CMKRNL CMEXEC NETMBX DIAGNOSE 
DETACH PRMCEB PRMMBX PHY_IO 
GRPNAM TMPMBX VOLPRO LOG_IO 
SYSNAM SYSPRV SETPRV GROUP 


Quotas 

BIOLM: 18 PRCLM: 8 

DIOLM: 55 ASTLM: 100 

FILLM: 100 BYTLM: 32768 
TQELM: 20 CPU: no limit 
ENOLM: 300 PGFLQUOTA: 20480 
WSDEFAULT: 256 WSQUOTA: 512 


WSEXTENT: 2048 


3 If any privileges or quotas are incorrect, run the Authorize Utility 
(AUTHORIZE) to add them (AUTHORIZE is explained in the VMS 
Authorize Utility Manual). As an alternative, you can temporarily 
assign the correct privileges with the DCL command SET PROCESS 
/PRIVILEGES. 


If you are logged in to the wrong account, the following error message asks 
you to log in to the SYSTEST account: 


$ QUETP 

FR AEE 
* UETINITOO * 
* Error count = 1 #* 


2 RRR Re a 2 kc 2 ke 2k ae 2 2 ak 2k akc 
-UETP-E-ABORT, UETINITOO aborted at 31-DEC-1988 14:24:10.13 
-UETP-E-TEXT, You are logged in to the wrong account. 
Please log in to the SYSTEST account. 
$ 


You must run UETP from the SYSTEST account. 
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9.5.4.2 


UVETINITO1 Failure 
UETINITO01 failures are related to peripheral devices; this type of error 
message might indicate any of the following: 


© Device failure 

¢ Device not supported or not mounted 
¢ Device allocated to another user 

e Device write-locked 

e¢ Lost vacuum on a magnetic tape drive 


¢ = Drive off line 


In some cases, the course of action you should take is explicit in the error 
message. For example, you might receive a message from the Operator 
Communication Facility (OPCOM) process informing you of a problem and 
recommending a corrective measure: 


%OPCOM, 31-DEC-1988 14:10:52.96, request 1, from user SYSTEST 
Please mount volume UETP in device _MTAO: 
YMOUNT-I-OPRQST, Please mount volume UETP in device _MTAO: 


Other error messages might relate information in which the solution is 
implicit: 


YUETP-S-BEGIN, UETDISKOO beginning at 31-DEC-1988 13:34:46.03 


FR 2 2 2 2 2 ie 2K a OK 2 oO 
* DISK_DRA * 
* Error count = 1 * 
2K OK 2 CK 2k eK 2 2 2K 2K OK OB oR 


-UETP-E-TEXT, RMS file error in file DRAO:DRAOO. TST 
-RMS-E-DNR, device not ready or not mounted 
Y%UETP-S-ENDED, UETDISKOO ended at 31-DEC-1988 13:34:46.80 


This message tells you that a disk drive is either not ready or not mounted. 
From this information, you know where to look for the cause of the failure— 
at the disk drive. If you cannot see the cause of the problem immediately, 
check the setup instructions in Section 9.3. 


In other cases, the cause of a failure might not be obvious from the 
information in the message. The problem might be related to hardware 
rather than software. For example, the Ethernet adapter test may produce 
one of the following messages if UETP does not have exclusive access to the 
Ethernet adapter: ‘ 


¢  Inter-module cable unplugged 

¢ Self-test failure code 0000000 

To run the self-test diagnostic on the Ethernet adapter successfully, UETP 
needs exclusive access to the adapter. Either DECnet or the LAT terminal 
server might also want to use the Ethernet adapter, which is a shareable 


device. UETP shuts down DECnet and the LAT terminal server for the 
duration of the device tests and restarts them when the tests are completed. 
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9.5.4.3 


Solution 


To determine where or when the failure occurs in the execution of UETP, use 
the following procedure: 


¢ Run the device test individually (see Section 9.4.1). By doing this, you 
can determine if the failure can be re-created. Also, you are isolating 
the cause of the problem by reproducing it using the least amount of 
software possible. For example, if the failure occurs only when you 
run the entire device phase, and not when you run the affected device 
test individually, you can conclude the problem is related to device- 
interaction. Conversely, if you can re-create the error by running the 
single device test, then you have proved that the error is not related to 
device interaction. 


e Run the device test with different media. If your run of the single device 
test succeeded in reproducing the error, the magnetic tape or disk media 
could be defective. Running the same test with new media determines 
whether this is the problem. 


¢ Call DIGITAL Field Service. If you have tried all the previous steps 
without solving the problem, you should contact your DIGITAL Field 
Service representative. 


Insufficient Disk Space 

When you run continuous passes of UETP, log files accumulate on the disk 
from which UETP was run. These files reduce the amount of free disk space 
available for each successive pass. If the amount of disk space available 
becomes too small for the current load, the following error message appears: 


“%UETP-S-BEGIN, UETDISKOO beginning at 31-DEC-1988 08:12:24.34 
“%UETP-I-ABORTC, DISK_DJA to abort this test, type “C 


PT TTTTrerrerTer se. te fs. 
* DISK_DJA * 

* Error count =1 * 

FEO RIOR A ICR RK 

-UETP-F-TEXT, RMS file error in file DJAO:DJAOO.TST 
-RMS-F-FUL, device full (insufficient space for allocation) 


Tort Trcrorrr errr ee ss] 
* DISK_DJA * 


* Error count = 2 ¥* 

Oe i a 2 ok ok oe 2 OK OK Kk OK OK KK 

-UETP-F-TEXT, RMS file error in file DJAQ:DJAO1.TST 

-RMS-F-FUL, device full (insufficient space for allocation) 
“%UETP-E-DESTP, DISK_DJA stopped testing DJA unit O at 08:12:36.91 
4UETP-S-ENDED, UETDISKOO ended at 31-DEC-1988 08:12:37 .98 


Solution 


Make more space available on the disk. You can do this by using one or 
more of the following techniques: 


¢ Delete unnecessary files to create more space. 
¢ Purge files, if multiple versions exist. 


* Mount a volume with sufficient space. 
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e Check for disk quotas that may be enabled on the disk. If disk quotas 
are enabled, either disable or increase them (see the VMS SYSMAN Utility 
Manual for a description of the Disk Quota Utility). 


e Run VMSTAILOR if you have a small-disk system. See Chapter 8 for 
more information. 


See Sections 9.2.1 and 9.3.2 for a further discussion of disk space. 


Incorrect Setup of a VAXcluster 

Most problems that can occur during the cluster-integration test are related 
to improper setup of the VAXcluster or of UETP on the VAXcluster. These 
problems are most likely to occur at the following stages of the VAXcluster 
test: 


¢ Near the beginning, when processes on VMS nodes are started 


* Toward the end, when cluster file access is checked 


The cluster test phase shows that various VMS nodes in your cluster can 
simultaneously access files on selected nodes in the cluster. First, UETP tries 
to create a file on a disk drive that is accessible to the other selected nodes 
in the cluster. The following are the requirements for creating a file in the 
cluster test phase: 


¢ There must be a [SYSTEST] directory on the disk in either the master file 
directory (MFD) or in the root directory [SYSO.]. 


¢ The [SYSTEST] directory must be protected so that the SYSTEST account 
can create a file in it. 


If UETP is unable to find a suitable device on a certain node, the test displays 
a waming message and proceeds to the next cluster node. 


Nodes on which the operator’s terminal (OPAQ) is set to the “No Broadcast” 
terminal characteristic will generate the following error message during the 
cluster test: 


2 2 eo 3 ok ie ak ok a 8 ok kK AE 

* UETCLIGOOmaster +* 

* Error count = 1 * 

2 Ae ak ke ke 9 2 2 2 2 2 ac 2 oe 2k a 2 a ok 

-UETP-E-TEXT, 0 operator consoles timed out on the cluster test warning 
and 1 operator console rejected it. 

-UETP-E-TEXT, Status returned was, 
"Y¥SYSTEM-F-DEVOFFLINE, device is not in configuration or not 
available" 


Disregard this message if OPAO is set to “No broadcast”. 


Solution 


Whenever you suspect a problem, you should try to recover the 
SYS$TEST:NETSERVER.LOG file that was created when the SYSTEST_ 
CLIG process was created. This file may contain additional error information 
that could not be transmitted to the node running the test. If it was not 
possible to create the SYSTEST_CLIG process on some node, the system 
accounting file for that node may contain a final process status in a process 
termination record. 
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9.5.4.5 


The following problems can occur during a cluster test: 


* Logging in at other nodes—This problem is due to incorrect setup for the 
cluster test at the remote VMS node. For example, if you specified 
a password for the SYSTEST_CLIG account or if you disabled the 
SYSTEST_CLIG account, the test displays the following message: 


“%SYSTEM-F-INVLOGIN, login information invalid at remote node 


Refer to Section 9.3.13 and Section 9.5.2.1 for information on preparing 
for VAXcluster testing. 


¢ Communicating with other nodes—A message indicates a DECnet 
problem. Check the NETSERVER.LOG file on the affected node to 
determine the cause. 


¢ Taking out locks or detecting deadlocks—The most likely cause of this 
problem is that you are not logged in to the SYSTEST account. Another 
possibility is that your cluster is not configured properly. 


¢ Creating files on VAXcluster nodes—This problem is due to incorrect 
setup for the cluster test; refer to Section 9.3.13 for information on 
preparing for VAXcluster testing. 


Problems During the Load Test 

A variety of errors can occur during the load test, because the command 
procedures that are started during the tests run several utilities and do many 
functions. Tracking a problem can be difficult because UETP deletes the log 
files that are generated during the load test (see Section 9.6.3). 


Solution 


If a problem occurs during the load test and the cause is not obvious, you can 
modify UETP.COM to preserve the log files as follows: 


1 Add the /NODELETE qualifier to the following line: 

$ TCNTRL UETLOADOO . DAT/PARALLEL_COUNT='LOADS/REPORT_TYPE='REPORT 
2 Delete the following line: 

$ DELETE UETLO*.LOG;* 


Rerun the load test with these changes to try to re-create the problem. 


If you re-create the problem, look at the contents of the appropriate log file. 
To determine which log file to read, you need to understand the scheme by 
which the load test names its processes and log files. (The log file names are 
derived from the process names.) 


The load test creates processes that are named in the following format: 
UETLOADnn_nnnn 


For example: 
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“%UETP-I-BEGIN, UETLOADOO beginning at 31-DEC-1988 15:45:08.97 

“ZUETP-I-BEGIN, UETLOADO2_0000 beginning at 31-DEC-1988 15:45:09.42 
“%UETP-I-BEGIN, UETLOADO3_0001 beginning at 31-DEC-1988 15:45:09.63 
“4UETP-I-BEGIN, UETLOADO4_0002 beginning at 31-DEC-1988 15:45:10.76 
%UETP-I-BEGIN, UETLOADO5_0003 beginning at 31-DEC-1988 15:45:11.28 
“ZUETP-I-BEGIN, UETLOADO6_0004 beginning at 31-DEC-1988 15:45:12.56 
“UETP-I-BEGIN, UETLOADO7_0005 beginning at 31-DEC-1988 15:45:13.81 
ZUETP-I-BEGIN, UETLOADO8_0006 beginning at 31-DEC-1988 15:45:14.94 
#UETP-I-BEGIN, UETLOADO9_0007 beginning at 31-DEC-1988 15:45:16.99 
“%UETP-I-BEGIN, UETLOAD10_0008 beginning at 31-DEC-1988 15:45:19.32 
“ZUETP-I-BEGIN, UETLOAD11_0009 beginning at 31-DEC-1988 15:45:19.94 
“UETP-I-BEGIN, UETLOADO2_0010 beginning at 31-DEC-1988 15:45:20.20 
ZVETP-I-BEGIN, UETLOADO3_0011 beginning at 31-DEC-1988 15:45:21.94 
“%UETP-I-BEGIN, UETLOADO4_0012 beginning at 31-DEC-1988 15:45:22.99 


Note that if more than ten processes are created, the numbering sequence for 
the UETLOADnn portion of the process name starts over at UETLOADO2; 
however, the four digits of the _nnnn portion continue to increase. 


Each load test process creates two log files. The first log file is created by the 
test controller; the second log file is created by the process itself. The log file 
that you need to look at for error information on any given load test process 
is the one that was created by the test controller (the first log file). 


The load test log file derives its file name from the process name, appending 
the last four digits of the process name (from the —nnnn portion) to UETLO. 
The test-controller log file and the process log file for each process use the 
same file name; however, the process log file has the higher version number 
of the two. For example, the log files created by the process UETLOAD05_ 
0003 would be named as follows: 


UETLO0003.LOG;1 (test-controller log file) 
UETLO0003.LOG;2 (process log file) 


Make sure that you look at the log file with the lower version number; that 
file contains the load test commands and error information. 


After you have isolated the problem, restore UETP.COM to its original state 
and delete the log files from the load test (UETLO*.LOG;*); failure to delete 
these files might result in disk space problems. 


DECnet Error 
A DECnet error message might indicate that the network is unavailable. 


Solution 


e If DECnet is included in your system, register the authorization key (see 
the VMS Release Notes). 


¢ If DECnet is not included in your system, ignore the message; it is normal 
and does not affect the UETP run. 


If you encounter other DECnet-related errors, you should do the following: 


* Run DECnet as a single phase (see Section 9.4.1) to determine whether 
the error can be re-created. 


* Refer to the VMS System Messages and Recovery Procedures Reference 
Volume. 
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9.5.4.7 


9.5.4.8 


Errors Logged But Not Displayed 

If no errors are displayed at the console terminal or reported in the 
UETP.LOG file, you should run the Error Log Utility to see if any errors 
were logged in the ERRLOG.SYS file. See the VMS Error Log Utility Manual 
for information about running the Error Log Utility. 





No PCB or Swap Slots 
The following error message indicates that no process control block (PCB) or 
swap slots are available: 


YUETP-1-BEGIN, UETLOADOO beginning at 31-DEC-1988 07:47:16.50 

%UETP-I-BEGIN, UETLOADO2_0000 beginning at 31-DEC-1988 07:47:16.76 

%UETP-I-BEGIN, UETLOADO3_0001 beginning at 31-DEC-1988 07:47:16.92 

{UETP-I-BEGIN, UETLOADO4_0002 beginning at 31-DEC-1988 07:47:17.13 

YUETP-I-BEGIN, UETLOADO5_0003 beginning at 31-DEC-1988 07:47:17.35 

%UETP-I-BEGIN, UETLOADO6_0004 beginning at 31-DEC-1988 07:47:17.61 

{UETP-W-TEXT, The process -UETLOADO7_0005- was unable to be created, 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

%UETP-W-TEXT, The process -UETLOADO8_0006- was unable to be created, 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

YUETP-W-TEXT, The process -UETLOADO9_0007- was unable to be created, 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

Y%UETP-W-TEXT, The process -UETLOAD10_0008- was unable to be created, 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

%UETP-W-TEXT, The process -UETLOAD11_0009- was unable to be created, 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

%UETP-W-ABORT, UETLOADOO aborted at 31-DEC-1988 07:47:54.10 

-UETP-W-TEXT, Aborted via a user CTRL/C. 

FR RR A ROC a a ak 2 2 aE fC aE 2 Fe 2k 2 2 2 2 2 2 2 of 2 a 2 2 2 ake oe ae ok og oi a 2 ea a ak ae 

* * 

END OF UETP PASS 1 AT 31-DEC-1988 07:48:03.17 
* * 
3 AG oe i fe ke 2 2 fe he ie oo A ICC IC 9 Fe C3 2 9 8 2 2 2 2 2 2 ee 2g fe 2 2 2k ie ae afc ae oe oe ok ae oc ak ac 


Solution 
To solve this problem, use the following procedure: 


1 Rerun individually the phase that caused the error message (the LOAD 
phase in the previous example) to see if the error can be reproduced. 


2 Increase the size of the page file, using either the command procedure 
SYS$UPDATE:SWAPFILES.COM or the System Generation Utility (see 
the VMS System Generation Utility Manual). 


3 Increase the SYSGEN parameter MAXPROCESSCNT, if necessary, and 
reboot the system. 


4 Increase both the page file size and the MAXPROCESSCNT, if necessary. 
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9.5.4.9 Hangs 
If there is no keyboard response or system disk activity, the system may be 
hung. 


Solution 


A system hang can be difficult to trace; you should always save the dump file 
for reference. To learn why the system hung, run the System Dump Analyzer 
as described in the VMS System Dump Analyzer Utility Manual. Reasons for a 
system hang include the following: 


* Insufficient pool space—Reboot the system with a larger value for 
NPAGEVIR. 


¢ Insufficient page file space—Increase the page file space using the System 
Generation Utility as described in the VMS System Generation Utility 
Manual. 


e I/O device failure causing driver-permanent loop—Call DIGITAL Field 
Service. 


9.5.4.10 Bugchecks and Machine Checks 
When the system aborts its run, a bugcheck message appears at the console. 


Solution 


Call DIGITAL Field Service. Often a hardware problem causes bugchecks and 
machine checks; there is no easy way to solve bugchecks or machine checks. 
It is important, however, that you save the SYS$SYSTEM:SYSDUMP.DMP 
and ERRLOG.SYS files so that they are available for examination. It is also 
important to know whether the failure can be re-created; you can verify this 
by running UETP again. 





9.6 UETP Tests and Phases 


This section explains in detail the organization of UETP and the individual 
components within the test package. 


You run UETP by starting a master command procedure, which contains 
commands that start each test phase. The procedure begins by prompting 
you for information needed by the various test phases. (See Section 9.4 for a 
detailed description of starting UETP.) 


The master command procedure, UETP.COM, contains commands that 
initiate each test phase. UETP.COM also contains commands that do such 
tasks as defining logical names and manipulating files generated by the tests. 


The UETP.COM procedure also issues commands to start the test controlling 
program, UETPHAS00.EXE, which in turn controls each test phase. The 
test controller starts up multiple detached processes. It also reports their 
completion status and other information the processes report to it. 


The following sections describe the various UETP test phases. 
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9.6.1 Initialization Phase 


The following occurs during the initialization phase: 


¢ The image UETINITOO.EXE prompts you for information (see Section 9.4). 
Your information defines variables that affect the execution of UETP tests. 


¢ The image UETINITO1.EXE gathers information on all the controllers 
in the system and on their associated devices. This image writes the 
information into a file called UETINIDEV.DAT. 


e Using the information in UETSUPDEV.DAT, UETINITO1.EXE verifies 
which devices in the system are operable by running the appropriate 
device test. Each device test completes a simple read/write operation 
to each device. If a device fails this test, the device’s entry in 
UETINIDEV.DAT specifies that the device cannot be tested. As a result, 
subsequent UETP tests ignore that device. 


e For each testable controller, UETINIT01.EXE writes a line into a file called 
UETCONTO00.DAT. The line associates a test file with the controller it 
tests. 


A summary of UETINIDEV.DAT always exists in UETP.LOG, and 
UETINITO01.EXE sends that summary to the console if you have requested 
the long report format. 


9.6.2 Device Test Phase 
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The device test phase includes separate tests for each type of device, such 
as disk, magnetic tape, line printer, and terminal. This section explains the 
device test phase and presents instructions for testing a single device. If you 
want to run the entire device test phase individually, refer to Section 9.4.1. 


How the Device Phase Works 

The UETP device test phase starts an executable image, the phase controller 
UETPHAS00, which creates a detached process for every device controller 
to be tested. For example, if a system includes three terminal controllers, 
one line printer controller, and two disk controllers, the image creates six 
detached processes. In parallel, the detached processes execute images that 
test the various types of devices. 


The initialization phase of UETP creates a file called UETINIDEV.DAT 

and a file called UETCONTO00.DAT. UETINIDEV.DAT contains data on 

the VMS-supported controllers in the system and their associated devices; 
UETCONTO00.DAT associates a device test image with each testable controller. 


UETPHAS00 uses the information in UETCONTO00.DAT to find a device 
controller name to pass to each detached process that it creates. UETPHAS00 
passes the controller name by writing it to a mailbox that is SYS$INPUT to 
individual tests. Each detached process uses that data to determine which 
controller to test. The test image then searches UETINIDEV.DAT for the 
device controller and for all testable units on that controller. The phase 
controller terminates when all devices on all controllers have completed 
testing. 


Because UETCONT00.DAT is deleted automatically at the end of a UETP run, 
you cannot run the device phase unless you start UETP.COM; you can run 
only individual test images. UETINIDEV.DAT exists in SYS$TEST unless you 
explicitly delete it. 


9.6.2.2 


Running UETP 
9.6 UETP Tests and Phases 


Running a Single Device Test 

You must be logged in to the SYSTEST account to run the individual tests as 
described in this section. Also, a copy of UETINIDEV.DAT must exist. If a 
copy of the file is not present from a previous run (a run of the entire UETP 
or a run of the device test phase creates UETINIDEV.DAT), you can create it. 
Note that when you run a single test, no log file is created; the test sends all 
its output to your terminal. 


If you do not want to test all the device types, you can test a specific 
controller by choosing a test image name from Table 9-1 and executing it 
as in the following example: 


$ RUN UETTTYSOO 
Controller designation?: TIB 


UETP prompts you for the controller designation and the device code. Unless 
you are testing your own terminal, you must explicitly designate a controller 
name. If you are running the terminal test, you can press RETURN to test 
your terminal only. 


If you plan to repeat the run several times, you might find it more convenient 
to define the logical name CTRLNAME as follows: 


$ DEFINE CTRLNAME TTB 
$ RUN UETTTYSOO 


When you define the controller name in this way, the logical name 
CTRLNAME remains assigned after the test completes. To deassign this 
logical name, use the DCL command DEASSIGN as follows: 


$ DEASSIGN CTRLNAME 


Format of VETINIDEV.DAT 


The UETINIDEV.DAT file is an ASCII sequential file that you can type or edit 
if necessary. The contents of this file are shown in the following command 
sequence: 


$ TYPE UETINIDEV.DAT 
DDB x ddd 

UCB y uuuuu 

END OF UETINIDEV.DAT 


The symbols in this example are defined as follows: 


Symbol Value 





x T, if there are any testable units for this controller; N, if this controller 
is not to be tested 

y T, if this unit is testable; N, if this unit is not testable 

ddd device controller name, for example DUA 

uuuuu device unit number, for example 25 


UETINIDEV.DAT contains a DDB (device data block) line for each controller 
connected or visible to your system. After the DDB line there is a UCB (unit 
control block) line for each unit connected to that controller. In addition, if 
your system uses MA780 memory in a loosely coupled CPU configuration, 
UETINIDEV.DAT includes one UCB line for each MA780 memory. A device 
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test can test a particular device only if both the DDB line and the UCB line 
indicate that the device is testable. 


Running a Test in Loop Mode 


If you want to put extra stress on a device, you can run the device test in loop 
mode, which causes the test to run indefinitely. For example: 


$ DEFINE MODE LOOP 

$ RUN UETDISKOO 

Controller designation?: DRA 

Y%UETP-I-TEXT, End of pass 1 with 980 iterations at 31-DEC-1988 16:18:51:03 


“¢C 


You must use CTRL/C to terminate the test run. If you use CTRL/Y, UETP 
does not complete cleanup procedures. 


Functions of Individual Device Tests 


For each disk in the system, the disk test allocates two files into which it 
randomly writes blocks of data. The test then checks the data, reports any 
errors to SYS$OUTPUT, and deletes the disk files. 


When you run the disk test phase in a cluster environment, the test accesses 
all disks that are mounted by the system being tested, and users of the disk 
being tested might encounter an insufficient disk space problem. You should 
warn users on remote nodes (who share disks with users on the local system) 
that UETP may be testing a disk they are using. 


The magnetic tape test exercises all the magnetic tape drives in the system. 
The test creates a large file on each mounted magnetic tape, into which 

it writes multiple sequential records of varying sizes. After writing the 
records, the test rewinds the magnetic tape, validates the written records, and 
reinitializes the magnetic tape. 


The terminal and line printer test generates several pages or screens of 
output, in which each page or screen contains a header line and a test pattern 
of ASCII characters. A header line contains the test name, the device name, 
the date, and the time. 


For the laboratory peripheral accelerator (LPA11-K), the test image 
determines the configuration on the LPA11-K’s I/O bus. The image loads all 
types of microcode to the LPA11-K and reads or writes data for each device 
on the LPA11-K I/O bus. 


The communications device tests fill the transmit message buffer with random 
data; then, using loopback mode, they transmit and receive the message 
several times. To check that the looped-back data is correct, an AST routine 
is associated with a $QIO read to compare the received message against the 
transmitted message. The procedure is repeated using messages of different 
lengths. 


The interface device tests put their respective devices in maintenance mode, 
write random data, and then verify the data. 


The MA780 device test creates and modifies mailboxes, common event flags, 
and global sections in shared memory; then it verifies that modifications can 
be made. You can run MA780 tests in parallel from separate systems so that 
the tests interact with each other through common MA780 memories. 
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The Ethernet adapter test does self-test diagnostics on the device. It also does 
read and write tasks with test data that uses various adapter modes (such as 
internal loopback and external loopback). 


Table 9-1 lists the device test images and the devices to be tested. 


Table 9-1 The Device Tests 


Test Image Name Devices Tested 


UETDISKOO.EXE Disks 

UETTAPEOO.EXE Magnetic tape drives and tape cartridge drives 
UETTTYSOO.EXE Terminals and line printers 

UETLPAKOO.EXE LPA11—K 

UETCOMSOO.EXE DMC11, DMR11 

UETDMPFOO.EXE DMF32, DMP 1 1 

UETDR1WO0.EXE DR11—W 

UETDR7800.EXE DR780, DR750 

UETMA7800.EXE MA780 

UETUNASOO.EXE Ethernet Adapters 





9.6.3 System Load Test Phase 


The purpose of the system load test is to simulate a number of terminal 
users who are demanding system resources simultaneously. The system load 
tests, directed by the file UETLOADO00.DAT, create a number of detached 
processes that execute various command procedures. Each process simulates 
a user logged in at a terminal; the commands within each procedure are 
the same types of commands that a user enters from a terminal. The load 
test creates the detached processes in quick succession, and generally the 
processes execute their command procedures simultaneously. The effect on 
the system is analogous to an equal number of users concurrently issuing 
commands from terminals. In this way, the load test creates an environment 
that is similar to normal system use. 


The load test uses the logical name LOADS to determine the number 

of detached processes to create. When you initiate the UETP command 
procedure, it prompts for the number of users to be simulated (see 
Section 9.4.3) and consequently the number of detached processes to be 
created. Your response, which depends on the amount of memory and the 
swapping and paging space in your system, defines the group logical name 
LOADS. 


The UETP master command procedure deassigns all group logical names 
assigned by its tests as part of the termination phase. The group logical 
name LOADS remains assigned only if the UETP package does not complete 
normally. 


The command procedures executed by the load test can generate a large 
amount of output, depending on the number of detached processes created. 
For each detached process (or user), the test creates a version of an output file 
called UETLOnnnn.LOG (“nnnn’ represents a string of numeric characters). 
The console displays only status information as the load test progresses. 
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Whether the load test runs as part of the entire UETP or as an individual 
phase, UETP combines the UETLOnnnn.LOG files, writes the output to the 
file UETP.LOG, and deletes the individual output files. 


You can run the system load test as a single phase by selecting LOAD from 
the choices offered in the startup dialog (see Section 9.4.1). 


9.6.4 DECnet Test Phase 
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9.6.4.1 


9.6.4.2 


If DECnet is included in your VMS system, a run of the entire UETP 
automatically tests DECnet hardware and software. Because communications 
devices are allocated to DECnet and the DECnet devices cannot be tested 
by the UETP device test, UETP shuts down DECnet for the duration of the 
initialization and device test phases. It turns DECnet on again after those 
phases are completed. The DECnet node and circuit counters are zeroed at 
the beginning of the DECnet test to allow for failure monitoring during the 
run. 


As with other UETP phases, you can run the DECnet phase individually by 
following the procedure described in Section 9.4.1. 


Environment 

The DECnet test will work successfully on VMS systems connected to all 
DECnet-supported node types, including routing and nonrouting nodes and 
several different types of operating systems (such as RSTS, RSX, TOPS, and 
RT). There must be some sort of default access on remote systems to copy 
files between systems. The DECnet phase tests the following: 


* The node UETP is running on 
e All circuits in sequence 


¢ All adjacent or first-hop nodes and all circuits in parallel 


There is no limit on the number of communication lines supported by the 
tests. A test on one adjacent node should last no more than two minutes at 
normal communications transfer rates. 


How the DECnet Phase Works 

UETP (under the control of UETPHASO00.EXE) reads the file 
UETDNETO00.DAT and completes the following steps during the DECnet 
phase: 


1. Executes a set of Network Control Program (NCP) LOOP EXECUTOR 
commands to test the node on which UETP is running. 


2 Uses NCP to execute the command SHOW ACTIVE CIRCUITS. The 
results are placed in UETININET.TMP, from which UETP creates the data 
file VETININET.DAT. The UETININET.TMP file contains the following 
information for any circuit in the ON state but not in transition: 


e Circuit name 
e Node address 
¢ Node name (if one exists) 


The UETININET.TMP file is used throughout the DECnet phase to 
determine which devices to test. 


Note: 
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Uses the UETININET.TMP file to create an NCP command procedure 
for each testable circuit. Each command procedure contains a set of NCP 
commands to zero the circuit and node counters and to test the circuit 
and adjacent node by copying files back and forth. 


If you do not want the counters zeroed, do not test DECnet. 


Executes the command procedures from step 3 in parallel to simulate a 
heavy user load. The simulated user load is the lesser of the following 
values: 


e The number of testable circuits, multiplied by two 


¢ The maximum number of user-detached processes that can be 
created on the system before it runs out of resources (determined 
by UETINITO0) 


Executes a program, UETNETS00.EXE, that uses the UETININET.DAT 
file to check the circuit and node counters for each testable circuit. If a 
counter indicates possible degradation (by being nonzero), its name and 
value are reported to the console. All counters are reported in the log 
file, but only the counters that indicate degradation are reported to the 
console. Following is an example of UETNETSO0 output: 


YUETP-S-BEGIN, UETNETSOO beginning at 31-DEC-1988 13:45:33.18 
Y%UETP-W-TEXT, Circuit DMC-O to (NODENAME1) OK. 

%UETP-I-TEXT, Node (NODENAME2) over DMC-1 response timeouts = 
%UETP-I-TEXT, Circuit DMC-1 to (NODENAME2) local buffer errors 
Y%UETP-I-TEXT, Node (NODENAME3) over DMP-O response timeouts = 
YUETP-S-ENDED, UETNETSOO ended at 31-DEC-1988 13:45:36.34 


34. 


wo 


Because degradation is not necessarily an error, the test’s success is 
determined by you, not the system. The following counters indicate 
possible degradation: 


For Circuits 

e Arriving congestion loss 
* Corruption loss 

e Transit congestion loss 
e Line down 

e Initialization failure 

* Data errors inbound 

¢ Data errors outbound 
¢ Remote reply timeouts 
* Local reply timeouts 

* Remote buffer errors 

¢ Local buffer errors 

e Selection timeouts 

¢ Remote process errors 


e Local process errors 
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¢ Locally initiated resets 


e Network initiated resets 


For Nodes 

*® Response timeouts 

¢ Received connect resource errors 
e Aged packet loss 

¢ Node unreachable packet loss 

¢ Node out of range packet loss 

¢ Oversized packet loss 

¢ Packet format error 

« Partial routing update loss 


¢ Verification reject 


9.6.5 Cluster-Integration Test Phase 
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The cluster-integration test phase, which consists of a single program and 

a command file, depends heavily on DECnet. This phase uses DECnet to 
create SYSTEST_CLIG processes on each VMS node in the cluster and to 
communicate with each node. SYSTEST_CLIG is an account that is parallel 
to SYSTEST, but limited so that it can only be used as part of the cluster- 
integration test. The following restrictions on the SYSTEST_CLIG account are 
necessary for a correct run of the cluster test phase: 


¢ The account must be enabled and the password must be null. For more 
information, see Section 9.3.13. 


e The UIC must be the same as that of the SYSTEST account. 


¢ The account must have the same privileges and quotas as the SYSTEST 
account. For more information, see Section 9.5.4.1. 


¢ The account can allow login only through DECnet. 


¢ The account must be locked into running UETCLIGO0.COM when it logs 
in. 


These items are necessary to ensure the security and privacy of your system. 
If the test cannot create a SYSTEST_CLIG process on some VMS node, it 
gives the reason for the failure and ignores that node for the lock tests and 
for sharing access during the file test. The test makes no attempt to report 
information relating to a failure at the node where creation was attempted; 
that is, any possible log file is not copied to the node running the test. If 
there is a problem communicating with a SYSTEST_CLIG process after it has 
been created, the test excludes it from further lock and file sharing tests. At 
the end of the cluster-integration test, an attempt is made to report any errors 
seen by that node. 
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UETCLIG00.EXE has two threads of execution: the primary and the 
secondary. The first, or primary thread, checks the cluster configuration; 
that is, it checks the VMS and HSC nodes and the disks attached to each 

of them that can be seen from the node running the test. For selected VMS 
nodes, the primary thread attempts to start up a SYSTEST_CLIG process 
through DECnet. Those nodes on which the primary thread was able to start 
a SYSTEST_CLIG process run the command file UETCLIG00.COM, which 
starts up UETCLIGO0.EXE and runs the secondary execution thread. 


The process running the primary thread checks to see that it can communicate 
with the processes running the secondary threads. It then instructs them to 
take out locks so that a deadlock situation is created. 


The primary thread tries to create a file on some disk on selected VMS and 
HSC nodes in the cluster. The primary thread writes a block, reads it back 
and verifies it. The primary thread selects one VMS node at random and 
asks that node to read the block and verify it. The primary extends the file 
by writing another block and has the secondary read and verify the second 
block. The file is deleted. 


The secondary processes exit. They copy to the primary process the contents 
of their SYS$ERROR files, so that the UETP log file and console report 
show all problems in a central place. DECnet automatically creates a 
NETSERVER.LOG in SYS$TEST as the test is run, so that if necessary, 

you can read that file later from the node in question. 


During the test run, the primary process uses cluster $BRKTHRU to announce 
the beginning and ending of the test to each VMS node’s console terminal. 


You can define the group logical name MODE to the equivalence string 
DUMP to trace most events as they occur. Note that the logical name 
definitions apply only to the node on which they were defined. You must 
define MODE on each system in the VAXcluster on which you want to trace 
events. 
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Part Il 


Part Il describes frequently performed system operations such as system 
startup, shutdown, and backup. 





10 Startup and Shutdown Procedures 


This chapter contains information on the following: 
°¢ Overview of booting the system 

* Creating default boot command procedures 

¢ Different ways to boot the system 


¢ Shutting down the system 


em el 


10.1 Overview of Booting 


Booting is the process of loading system software into memory. The 
VAX-11/725 and VAX-11/730 use boot command procedures to boot the 
VMS operating system from the system disk into memory. A boot command 
procedure does the following: 


e Sets up the system environment 
¢ Deposits values in registers 


e Tells the system what type of drive the system disk is on as well as the 
controller designation and the unit number of the drive 


e¢ Loads the VMS operating system into memory 
e §©Starts the CPU 


The instructions for booting the system vary slightly for different types of 
drives. Therefore, there is a boot command procedure for each type of drive 
that the processor supports. 


For example, on a VAX-11/730 you can boot an RA60 drive that has a unit 
number of zero with the boot command procedure DU0OBOO.CMD (assuming 
the controller designation is A). If the drive has a unit number of one, use the 
boot command procedure DU1BOO.CMD. 


All boot command procedures are located on the console TU58. The console 
TU58 must be in the console tape cassette drive (CSA2) whenever you boot 
the system. To view the contents of the console TU58, use the following 
procedure: 


Note: This procedure assumes that the VMS operating system is running and 
that you are logged into the SYSTEM account. 


1 Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


2 To connect the console drive to the system, enter the following commands 
and press RETURN after each one: 


$ RUN SYS$SYSTEM: SYSGEN 


SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 
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3 Use the Exchange Utility to display a list of the boot command procedures 


on the console TU58. Boot command procedures are files that start with 
D and end with either BOO or GEN. The file type is CMD. Enter the 
following command and press RETURN: 


$ EXCHANGE DIRECTORY CSA2:D*.CMD 
For example: 


Directory of RT-11 volume _$CSA2: 31-DEC-1988 15:00 


DUOGEN . CMD 
DU1B00.CMD 
DUAGEN . CMD 


You can view the contents of a file with the TYPE command. For 
example: 


$ EXCHANGE TYPE CSA2:DUOBOO.CMD 
When you are finished, enter the following command and press RETURN: 
$ DISMOUNT CSA2 


To secure the console TU58 from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA2 


The boot process consists of the following steps: 


1 


2 


“Oo | 


You enter the BOOT command. The specified boot command procedure 
deposits information in the general purpose registers. 


VMB.EXE, the primary boot program, is loaded into memory. VMB.EXE 
is a program that allows access to the system disk. VMB.EXE locates 
SYS$SYSTEM:SYSBOOT.EXE on the system disk and loads it into 
memory. 


SYSBOOT.EXE loads the SYSGEN parameters stored in 
SYS$SYSTEM:VAXVMSSYS.PAR and checks the conversational boot 
flag. If the flag is set, the procedure stops and displays the SYSBOOT> 
prompt. If the flag is not set, SYSBOOT.EXE loads the VMS executive 
into memory and transfers control to the VMS executive. 


When the VMS executive finishes, it executes the SWAPPER process. 
The SWAPPER creates the SYSINIT process. 
SYSINIT creates the STARTUP process. 


STARTUP executes SYS$SYSTEM:STARTUP.COM (unless you indicated 
another file at the SYSBOOT> prompt) and SYSTARTUP_V5.COM. 
The current values of SYSGEN parameters are written back to 
VAXVMSSYS.PAR. 


The boot process finishes, and you can log into the VMS operating 
system. 
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The following sections describe the different ways of booting a VAX-11/725 
and VAX-11/730. 


Note: If you plan to boot from a UDA50-supported disk drive, you must keep in 
mind the following restrictions when you configure the system: 


Each UNIBUS up to (but not including) the one that supports the 
system disk must have exactly one UDA50. Each UNIBUS from the 
system disk upwards, can have up to the legally allowable number of 
UDA5S0s. 


You can boot only from the first UDA50 on a UNIBUS (that is, the one 
with the fixed CSR and vector). 





10.2 Booting the System 


One way to boot the system is to enter the BOOT command followed by the 
name of a boot command procedure. Use the following procedure: 


1 


2 


Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


If the VMS operating system is not running, go to step 3. 


If the VMS operating system is running, log into the SYSTEM account. 
Enter the following command and press RETURN: 


$ @SYS$SYSTEM : SHUTDOWN 


Answer the questions. When the procedure asks if an automatic system 
reboot should be performed, press RETURN for NO. When the procedure 
is finished, it displays the following message: 


SYSTEM SHUTDOWN COMPLETE -- USE CONSOLE TO HALT SYSTEM 
Press CTRL/P to put the system in console mode. 


Enter the BOOT command followed by the boot name for the drive that 
holds the system disk. The format for a boot name is as follows: 


ddu 
where: 


e dd is the device code (Table 10-1 lists the device codes to use in boot 
names) 


e wis the unit number 


Table 10-1 Device Codes for a VAX—11/725 and VAX-11/730 


Device Used in a Boot Name 


RC25, RA60, RA80, RA81, and RA82 DU 
disk drives 


R80 disk drive DQ 


For example, if you have a VAX-11/725, enter the BOOT command 
followed by the boot name of the fixed RC25 disk (the system disk), as 
follows: 
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>>> B DUI 


Suppose you have a VAX-11/730 and the system disk is on an RA80 disk 
drive with a controller designation of A and a unit number of zero. Enter 
the following command and press RETURN: 


>>> B DUO 


If you have a VAX-11/730, you can also specify a boot name in the 
following format: 


ddc 

where: 

e dd is the device code 

¢ cis the controller designation 


If you use this format, you must first use the DEPOSIT command to tell 
the system the unit number of the drive holding the system disk. For 
example, if you have a VAX-11/730 and the system disk is on an RA80 
drive with a controller designation of B and a unit number of three, enter 
the following commands: 


>>> DEPOSIT R3 3 
>>> B DUB 


You can also set up default boot command procedures so that the system 
automatically boots from a particular drive. For more information, see 
Section 10.3. 


10.3. Creating Default Boot Command Procedures 
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Note: 


Another way to boot the system is to create default boot command procedures 
that boot the system automatically. There are two default boot command 
procedures: DEFBOO.CMD and DEFGEN.CMD. 


DEFBOO.CMD is the nonstop boot procedure. When you boot with 
DEFBOO.CMD, you have no control over the system until the boot process 
has finished. Use DEFGEN.CMD, the conversational boot procedure, when 
you want to interrupt the boot process and change system parameters. 


DEFGEN.CMD and DEFBOO.CMD do not exist on the console TU58. 
However, DIGITAL provides boot command procedures that you can edit 
and rename using the following procedure. This procedure assumes the VMS 
operating system is running. 


This procedure assumes that the VMS operating system is running and 
you are logged into the SYSTEM account. 


1 Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


2 To connect the console drive to the system, enter the following commands 
and press RETURN after each one: 


$ RUN SYS$SYSTEM:SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 
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Use the Exchange Utility to display a list of the boot command procedures 
on the console TU58. Enter the following command and press RETURN: 


$ EXCHANGE DIRECTORY CSA2:D*.CMD 


Look at the list of files. Look for the files whose first two letters match 
the device code of the drive holding the system disk. For example, if the 
system disk is on an RA80 drive, find the file names that begin with DU 
(DU is the device code for an RA80 disk drive). 


If the third character in the file name is a number, it stands for the 

unit number of a drive with a controller designation of A. For example, 
DU1BOO.CMD boots an RA80 disk drive with a controller designation of 
A and a unit number of one. 


If the third character in the file name is a letter, it stands for the controller 
designation. There is no corresponding unit number. For example, 
DUCBOO.CMD boots an RA80 disk drive with a controller designation 
of C. 


Use the Exchange Utility to copy the appropriate files from the console 
TU58 to your current directory on the system disk. Enter the COPY 
command in the following format: 


$ EXCHANGE COPY CSA2:filename.CMD * 


Substitute the file name of the boot command procedure for filename. 
For example, to make a copy of DUOBOO.CMD, enter the following 
command and press RETURN: 


$ EXCHANGE COPY CSA2:DUOBOO0.CMD * 
If the third character of the file name is a number, go to step 8. 


If the third character of the file name is a letter, add a command to 
deposit the unit number of the drive holding the system disk in register 3 
(R3). Use hexadecimal notation. 


For example, suppose the system disk is on an RA80 disk drive with a 
controller designation of C and a unit number of three. After you copy 
DUCBOO.CMD and DUCGEN.CMD, add the following line to both files: 


DEPOSIT R33 !DISK DRIVE UNIT NUMBER 
Rename the files. Enter the RENAME command in the following format: 


$ RENAME filename .CMD DEFBOO.CMD 
$ RENAME filename.CMD DEFGEN.CMD 


where filename is the name of the boot command procedure. For example, 
to rename DUIBOO.CMD and DU1GEN.CMD, enter the following 
commands and press RETURN after each one: 


$ RENAME DUi1BO0.CMD DEFBOO.CMD 
$ RENAME DU1GEN.CMD DEFGEN.CMD 


Use the Exchange Utility to copy DEFBOO.CMD and DEFGEN.CMD to 
the console TU58. Enter the following commands and press RETURN 
after each one: 


$ EXCHANGE COPY DEFBOO.CMD CSA2:DEFBOO.CMD 
$ EXCHANGE COPY DEFGEN.CMD CSA2:DEFGEN.CMD 
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9 When you are finished, enter the following command and press RETURN: 
$ DISMOUNT CSA2 


10 To secure the console TU58 from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA2 


Now you can use DEFBOO.CMD and DEFGEN.CMD to boot the VMS 
operating system, as described in the following sections. 


10.3.1 Booting with DEFBOO.CMD 


As long as the console TU58 is in CSA2, you can boot the system with 
DEFBOO.CMD when you do any of the following: 


* Set the AUTO RESTART/BOOT switch to ON. Turn on the power. The 
system uses DEFBOO.CMD to boot automatically. 


* Set the keylock switch to LOCAL. At the console-mode prompt 
(> > > ), enter the following command to execute DEFBOO.CMD: 


>>> B 


e Set the keylock switch to LOCAL. When you see the console-mode 
prompt (> > > ) displayed on the console terminal, push the AUTO 
RESTART/BOOT switch to the BOOT position. The system executes 
DEFBOO.CMD. 


¢ Set the AUTO RESTART/BOOT switch to ON. Execute the SHUTDOWN 
command procedure and specify the auto reboot option. The system uses 
DEFBOO.CMD to reboot automatically. 


e If the AUTO RESTART/BOOT switch is set to ON when the system 
shuts down due to a bugcheck, the system uses DEFBOO.CMD to reboot 
automatically. 


The system sometimes uses DEFBOO.CMD when a power failure occurs. If 
the AUTO RESTART/BOOT switch is set to ON when a power failure occurs 
and the contents of memory are lost, the system executes DEFBOO.CMD 
when power is restored. 


If a power failure occurs and the battery backup unit saves the contents of 
memory, the system restarts execution where it was interrupted by the power 
failure. 


10.3.2 Booting with DEFGEN.CMD—Conversational Boot 
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A conversational boot is most commonly used in research and development 
environments and during software upgrades. Perform a conversational boot 
when you want to stop the boot process before it completes. The boot process 
stops after it loads SYS$SYSTEM:SYSBOOT.EXE and displays the SYSBOOT 
prompt (SYSBOOT> ). At the SYSBOOT> prompt, you can enter certain 
SYSGEN commands to do the following: 


* Look at system parameter values 


¢ Change system parameter values 
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Specify another parameter file 
Specify another system startup command procedure 


Select the default system parameter file if you modified system parameters 
to values that render the system unbootable 


Specify a minimum startup 


There are several ways to perform a conversational boot. The following 
procedure is the most direct: 


1 


2 


> Ww 


ol 


oO 


Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


If the VMS operating system is not running, go to step 3. 


If the VMS operating system is running, log into the SYSTEM account. 
Enter the following command and press RETURN: 


$ @SYS$SYSTEM: SHUTDOWN 


Answer the questions. When the procedure asks if an automatic system 
reboot should be performed, press RETURN for NO. When the procedure 
is finished, it displays the following message: 


SYSTEM SHUTDOWN COMPLETE - USE CONSOLE TO HALT SYSTEM 
Press CTRL/P to put the system in console mode. 


To begin the conversational boot, enter the following command and press 
RETURN: 


>>> @DEFGEN 


At the SYSBOOT> prompt, you can enter any of the SYSGEN 
commands listed in Table 10-2. For more information about these 
SYSGEN commands, see the VMS System Generation Utility Manual. 


When you finish using the SYSGEN commands, enter the CONTINUE 
command to complete the boot process. 


Table 10-2 SYSGEN Commands Used in SYSBOOT 


Command Description 

CONTINUE Resumes the boot process. 

DISABLE CHECKS Inhibits checking of parameter values 
specified with the SET command. 

ENABLE CHECKS Permits checking of parameter values 
specified with the SET command. 

HELP Displays a summary of the SYSBOOT 
commands on the terminal screen. 

SET parameter-name Establishes the vaiue of a system parameter. 

SET/STARTUP Sets the name of the system startup 


command procedure. 
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Table 10—2 (Cont.) SYSGEN Commands Used in SYSBOOT 


Command Description 





SHOW [parameter-name] Displays active, current, default, maximum, 
and minimum values for specific parameters. 
Use qualifiers to display characteristics of 
parameters grouped by categories. 


USE [file-spec] Specifies a parameter file to be used as 
a source of values {you must enter the 
entire file specification, including device and 
directory). 





The following examples illustrate some operations you can perform during a 
conversational boot. 


You can enter the following commands to set the SYSGEN parameter 
WSMAX to 512 and complete the boot process. 


SYSBOOT> SET WSMAX 512 
SYSBOOT> CONTINUE 


When the VMS operating system displays the following message, the new 
SYSGEN parameter value becomes active. 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 


If you modified the system parameters to values that render the system 
unbootable, enter the following commands to boot using default values: 


SYSBOOT> USE DEFAULT 
SYSBOOT> CONTINUE 


You can also use a conversational boot to specify a minimum startup. For 
example, if you want to boot the system and avoid autoconfiguring all your 
peripheral devices, enter the following command: 


SYSBOOT> SET STARTUP_Pi "MIN" 


This command initiates a minimum startup that performs the following 
sequence of operations: 


1 Starts the processes that control error logging, the job controller, and the 
operator's log 


2 Installs known images 
3 Defines the number of interactive users as eight 
4 Logs off 


Because this procedure does not call SYSTARTUP_V5.COM, it does not 
autoconfigure the system’s peripheral devices. 


The value of STARTUP_P1 is saved and affects future boot operations. After 
the operating system boots, you can run SYSGEN to reset STARTUP_P1. For 
example, enter the following commands to reset STARTUP_P1 to its default 
value (null): 
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$ RUN SYS$SYSTEM: SYSGEN 
SYSGEN> USE CURRENT 
SYSGEN> SET STARTUP_Pi "" 
SYSGEN> WRITE CURRENT 
SYSGEN> EXIT 

$ 


10.4 Booting with XDELTA 


XDELTA is a debugging tool that system programmers use. To use XDELTA, 
you need to boot the system in a special way. For information on booting 
with XDELTA, see the VMS Delta/XDelta Utility Manual. 


10.5 Booting from a Different Directory on the System Disk 


Note: 


The VMS operating system is installed on the system disk in a root directory 
named [SYSO]. If you have enough room on the system disk, you can use 
VMSKITBLD, described in the Guide to Setting Up a VMS System, to add a 
copy of the VMS operating system to another root directory on the system 
disk. 


To boot from a directory other than [SYSO], create a command procedure 
named SYnBOO.CMD, where 7 stands for the name of the other root 
directory on the system disk. To create SYnBOO.CMD, use the following 
procedure: 


This procedure assumes that the VMS operating system is running and 
you are logged into the SYSTEM account. 


1 Make sure that the console TU58 is in the console tape cassette drive 
(CSA2). 


2 To connect the console drive, enter the following commands and press 
RETURN after each one: 


$ RUN SYS$SYSTEM:SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


3 Use the Exchange Utility to copy DEFBOO.CMD from the console 
TU58 to your current directory on the system disk. Enter the following 
command and press RETURN: 


$ EXCHANGE COPY CSA2:DEFBOO.CMD * 


4 Edit DEFBOO.CMD. Change the line that deposits a value in register 5 
(R5). This line contains the comment !software boot flags. The value is a 
hexadecimal number with eight digits. For example: 


DEPOSIT R5 10000000 tsoftware boot flags 


Change the left-most digit to reflect the name of the root directory from 
which you want to boot. For example, if you want to boot from the 
directory named [SYSC], change the line as follows: 


DEPOSIT R5 CO000000 !software boot flags 


5 Rename DEFBOO.CMD to SYnBOO.CMD, where n stands for the name 
of the other system root directory. Use the following format: 


$ RENAME DEFBOO.CMD SYnBOO.CMD 
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For example, if the directory is named [SYSC], enter the following 
command and press RETURN: 


$ RENAME DEFBOO.CMD SYCBOO.CMD 


6 Use the Exchange Utility to copy SYnBOO.CMD to the console TU58. 
Use the following format: 


$ EXCHANGE COPY SYnBOO.CMD CSA2:SYnBOQ.CMD 


For example, if the file name is SYCBOO.CMD, enter the following 
command and press RETURN: 


$ EXCHANGE COPY SYCBOO.CMD CSA2:SYCBOO.CMD 
7 When you are finished, enter the following command and press RETURN: 
$ DISMOUNT CSA2 


8 To secure the console TU58 from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA2 


To boot from a different directory on the system disk, use the following 
procedure: 


1. Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


2 If the VMS operating system is not running, go to step 3. 


If the VMS operating system is running, log into the SYSTEM account. 
Enter the following command and press RETURN: 


$ @SYS$SYSTEM : SHUTDOWN 


Answer the questions. When the procedure asks if an automatic system 
reboot should be performed, press RETURN for NO. When the procedure 
is finished, it displays the following message: 


SYSTEM SHUTDOWN COMPLETE - USE CONSOLE TO HALT SYSTEM 
3 Press CTRL/P to put the system in console mode. 


4 Use SYnBOO.CMD to boot from a different directory. For example, to 
boot from [SYSC], enter the following command and press RETURN: 


>>> B SYC 





10.6 Ifthe System Does Not Boot 


If the system does not boot because a hardware problem occurs, a question 
mark (?) usually precedes the error message displayed on the console 
terminal. Examples of hardware problems are a read error on a disk drive or 
a machine check error. If you suspect a hardware problem, do the following: 


1 Consult the hardware manual for your VAX computer. 


2 Contact the appropriate DIGITAL Field Service representative. 
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When the operating system is loaded into memory, a message similar to the 
following appears on the terminal screen: 


SYSTEM job terminated at 31-DEC-1988 15:00:00.00 


If the system does not display this message, a software problem has probably 
occcurred. Do the following: 


1 Try to boot the system again. 


2 Place a backup copy of the system disk in another drive and try to boot 
from it. 


nn 


10.7. Shutting Down the System 


Before you shut down the VMS operating system, decide if you want the VMS 
operating system to reboot automatically or if you want to enter console-mode 
commands after the shutdown completes. 


If you want the VMS operating system to reboot automatically, set the 
AUTO RESTART/BOOT switch to ON. If you want to enter console-mode 
commands, stop the system after the shutdown completes. 


10.7.1 Types of Shutdowns 
You can perform the following three types of shutdown operations: 


* An orderly shutdown with SYS$SYSTEM:SHUTDOWN.COM. This 
procedure shuts down the system while performing maintenance 
functions such as disabling future logins, stopping the batch and printer 

ueues, dismounting volumes, and stopping user processes. To use the 
SHUTDOWN command procedure, log into the SYSTEM account, enter 
the following command and press RETURN: 


$ @SYS$SYSTEM : SHUTDOWN 
To stop the system after the procedure completes, press CTRL/P. 


For more information about the SHUTDOWN command procedure, see 
the Guide to Setting Up a VMS System. 


e An emergency shutdown with OPCCRASH.EXE. If you cannot perform 
an orderly shutdown with SHUTDOWN.COM, run the OPCCRASH 
emergency shutdown program. Enter the following command and press 
RETURN: 


$ RUN SYS$SYSTEM: OPCCRASH 
To stop the system after the procedure completes, press CTRL/P. 


For more information about OPCCRASH, see the Guide to Setting Up a 
VMS System. 


e An emergency shutdown with CRASH . Use this emergency shutdown 
procedure if OPCCRASH fails. The CRASH command procedure is 
on the console TU58. Section 10.7.2 describes the CRASH command 
procedure. 
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10.7.2 Emergency Shutdown with CRASH 


Note: Use CRASH only if the system is hung and you cannot log into the 
SYSTEM account to ure SHUTDOWN or OPCCRASH. 


The CRASH command procedure causes the system to fail, resulting in 
immediate shutdown. To force your system to fail with CRASH, do the 
following: 


1 Make sure the console TUS58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


2 Press CTRL/P to stop the system. 
3 Enter the following command and press RETURN: 


>>> @CRASH 


CRASH displays a fatal bugcheck message as well as additional messages 
and information. The procedure examines the program counter (PC), the 
processor status longword (PSL), and the stack pointers. It then deposits 
values in the PC and PSL to cause an exception condition that sends the 
contents of memory to the dump file on the system disk. Later you can 
read the dump file to determine why the system did not respond. 


4 CRASH halts the system, displays the contents of the program counter, 
and displays the console-mode prompt (> > > ). 


If the AUTO RESTART/BOOT switch is set to ON, the system reboots 
after CRASH runs. If the system does not reboot automatically, reboot it 
manually. 


5 After the system reboots, you can examine the dump file. To examine the 
dump file, log into the SYSTEM account. Enter the following commands 
and press RETURN after each one: 


$ ANALYZE/CRASH SYS$SYSTEM: SYSDUMP . DMP 
SDA> SHOW CRASH 


For more information about the System Dump Analyzer (SDA), see the 
VMS System Dump Analyzer Utility Manual. 
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11 Backup Procedures 


This chapter contains information on the following: 

e Installing and booting standalone BACKUP on the system disk 

¢ Installing and booting standalone BACKUP on TUS58 tape cassettes 
¢ Backing up and restoring the system disk 


You should also make a copy of the console TUS58 in case the original 
becomes damaged. 


11.1 Overview of Standalone BACKUP 


The Backup Utility lets you create and restore backup copies of files, 
directories, and user disks. Because the Backup Utility copies only what 

is on the disk and ignores sections of any open files contained in memory, 
you should use it to back up user disks, not the system disk. If you use the 
Backup Utility to back up the system disk, portions of the files that were in 
memory and data about files not yet written back to the disk (cache) will not 
be recorded on the resulting backup copy. 


Use standalone BACKUP to make a complete backup of the system disk. 
Standalone BACKUP is a version of the Backup Utitlity that runs without 
the support of the entire VMS operating system. Before you use standalone 
BACKUP, you must shut down the VMS operating system. The shutdown 
procedure sends the contents of the caches back to the disk and closes any 
open files. By shutting the system down and using standalone BACKUP, you 
can make an exact copy of the system disk. 


You can keep standalone BACKUP on the system disk, TU58 tape cassettes, 
or any other media that your system supports. DIGITAL recommends that 
you keep standalone BACKUP on the system disk and on tape cassettes. 
Usually you boot standalone BACKUP from the system disk because it saves 
time. However, you need a copy of standalone BACKUP on tape cassettes 
in case the system disk becomes damaged. If you have a magnetic tape 
distribution kit, you received standalone BACKUP on tape cassettes as part of 
the kit. 


11.1.1 Installing Standalone BACKUP on the System Disk 


You can install standalone BACKUP in any available root directory on the 
system disk from [SYS1] to [SYSE]. However, DIGITAL has established [SYSE] 
as the standard directory for standalone BACKUP. 


To install standalone BACKUP in [SYSE], use the following procedure: 
1 Log into the SYSTEM account. 
2 Enter the following command and press RETURN: 


$ @SYS$UPDATE:STABACKIT SYS$SYSDEVICE: 
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The procedure places the files in the directories [SYSE.SYSEXE] and 
[SYSE.SYS$LDR] on the system disk. It lists the files as they are copied. 
When the procedure finishes, it displays the following message: 


The kit is complete. 


3 Create a boot command procedure that lets you boot standalone BACKUP 
from [SYSE]. For more information, see Section 11.1.2. 


11.1.2 Booting Standalone BACKUP from the System Disk 


11-2 


You need a special boot command procedure to boot standalone BACKUP 
from the system disk. DIGITAL recommends that you modify an existing 
boot command procedure. Ideally, this should be the default boot command 
procedure, DEFBOO.CMD. 


You can choose any unique name in the form xxxBOO.CMD for the command 
procedure you create. However, DIGITAL suggests you use an existing file 
name and change the first letter to an X. For example, if you use a copy of 
DEFBOO.CMD, name the new file XEFBOO.CMD. 


To create a boot command procedure that boots standalone BACKUP from 
[SYSE], use the following procedure. The procedure assumes you are making 
a copy of DEFBOO.CMD and renaming it XEFBOO.CMD. 


1 Make sure that the console TU58 is in the console tape cassette drive 
(CSA2). 


2 Log into the SYSTEM account. 


3 To connect the console drive to the system, enter the following commands 
and press RETURN after each one: 


$ RUN SYS$SYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


4 Use the EXCHANGE Utility to copy DEFBOO.CMD to the current 
directory on the system.disk. Enter the following command and press 
RETURN: 


$ EXCHANGE COPY CSA2:DEFBOO.CMD XEFBOO.CMD 


5 Edit XEFBOO.CMD. Change the line that deposits a value in register 5 
(R5). Change the left-most digit so that it specifies the [SYSE] directory. 
For example: 


D/G/L 5 E0000000 'designated root is SYSE 
6 Exit from the editor to save the modified version of the file. 


7 To copy XEFBOO.CMD to the console TU58, enter the following 
command and press RETURN: 


$ EXCHANGE COPY XEFBOO.CMD CSA2:XEFBO0.CMD 
8 When you are finished, enter the following command and press RETURN: 
$ DISMOUNT CSA2 
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To secure the console TU58 from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA2 


To boot standalone BACKUP from [SYSE] on the system disk, use the 
following procedure: 


1 


2 


Make sure the console TU58 is in the console tape cassette drive (CSA2) 
and the keylock switch is set to LOCAL. 


If the VMS operating system is not running, go to step 3. 


If the VMS operating system is running, log into the SYSTEM account. 
Enter the following command and press RETURN: 


$ @SYS$SYSTEM : SHUTDOWN 


Answer the questions. When the procedure asks if an automatic system 
reboot should be performed, press RETURN for NO. When the procedure 
is finished, it displays the following message: 


SYSTEM SHUTDOWN COMPLETE -- USE CONSOLE TO HALT SYSTEM 
Press CTRL/P. 

Enter the following command and press RETURN: 

>>> @XEFBOO 


The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH::MM): 31-DEC-1988 15:00 
The procedure displays a list of the devices on your system. For example: 


Available device DAAO: device type RC25 
Available device DAA1: device type RC25 


Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


When standalone BACKUP finishes booting, it displays an identification 
message followed by the dollar-sign prompt ($): 


Y%BACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


To make a backup copy of the system disk, go to Section 11.2. 


To restore a backup copy of the system disk, go to Section 11.3. 
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11.1.3 Installing Standalone BACKUP on Tape Cassettes 


Note: 


As mentioned earlier, it is a good idea to have standalone BACKUP on tape 
cassettes in case the system disk becomes damaged. To install standalone 
BACKUP on tape cassettes, use the following procedure. 


If you have the VMS magnetic tape distribution kit, you already have 
standalone BACKUP on tape cassettes. If the original tape cassettes 
become damaged or you want to make extra copies, use this procedure. 


1 Obtain five TU58 tape cassettes. Affix a paper label to each one. Use a 
felt-tip pen to write a name on each label. Use the following names: 


S/A BKUP TUS58 V5.0 1/5 
S/A BKUP TUS58 V5.0 2/5 
S/A BKUP TUS8 V5.0 3/5 
S/A BKUP TU58 V5.0 4/5 
S/A BKUP TU58 V5.0 5/5 


A paper label is the label affixed to a tape cassette. The procedure 
displays a volume label, not the paper label, in messages. A volume label 
is the name the VMS operating system uses to refer to a tape cassette. 


2 Write-enable each tape cassette. Push the black RECORD switch in the 
upper left hand corner of the tape cassette to the left. 


3 Log into the SYSTEM account. 
4 Enter the following command and press RETURN: 


$ @SYS$UPDATE: STABACKIT 


5 The procedure asks you for the name of the target device. Type CSA1 
and press RETURN. For example: 


“%STABACKIT-I-SYMDEL, all global symbols deleted 
Enter the name of the device on which to build the kit: csai 


6 The procedure displays the following messages. Press RETURN (for YES) 
after each question. 


The standalone kit requires five TU58 cartridges. The first four 
TUS8 cartridges contain the standalone VMS system files, the last 
TUS8 cartridge contains the BACKUP application image. 


The system kit and the application kit can be built separately. 
Do you want to build the system kit? [Yes/No, default Yes]: 
Do you want to build the application kit? [Yes/No, default Yes]: 


7 The procedure gives you two options that you can use to verify the 
reliability of the standalone BACKUP kit. It uses the ANALYZE/MEDIA 
Utility to check for bad blocks. ANALYZE/MEDIA is only relevant for 
diskettes and disks. 


The procedure can also verify each file that it copies. This adds another 
hour and a half to the time it takes the procedure to run. DIGITAL 
suggests that you type Y and press RETURN when the procedure asks 
the following question: 


Do you want to verify copies? [Yes/No, default No]: 
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8 The procedure displays the following messages: 


Sysgen parameters for standalone VMS have been placed in file 
SYS$SYSROOT : <SYSUPD>VAXVMSSYS . PAR- TEMP-46E00121 ; 1 


Please place the first system TU58 cartridge in drive _CSA1:. 
This volume will receive the volume label SYSTEM_1. 


Enter "YES" when ready: 


Insert the tape cassette labeled S/A BKUP TU58 V5.0 1/5 in the CSA1 
drive. When you are ready to continue, type Y and press RETURN. 


o 


10 The procedure mounts the tape cassette, copies a set of system files, and 
displays a number of informational messages. For example: 


%MOUNT~I_MOUNTED, SYSTEM_1 mounted on _CSA1: 
%CREATE-I-CREATED, _CSA1:<SYSO.SYSEXE> created 
%CREATE-I-CREATED, _CSA1:<SYSO.SYS$LDR> created 


11 When the last file is copied, the procedure asks you to insert the next tape 
cassette. Remove the tape cassette labeled S/A BKUP TU58 V5.0 1/5. 
Insert the tape cassette labeled S/A BKUP TU58 V5.0 2/5. When you are 
ready to continue, type Y and press RETURN. For example: 


Please place the second system TU58 cassette in drive _CSA1:. 
This volume will receive the volume label SYSTEM_2. 


Enter "YES" when ready: y 
12 Repeat steps 8 through 10 for each tape cassette. 
13 When the procedure finishes, it displays the following message: 


The kit is complete. 


11.1.4 Booting Standalone BACKUP from Tape Cassettes 


If the system disk containing standalone BACKUP should become unusable, 
you can boot standalone BACKUP from TUS58 tape cassettes. You need the 
five tape cassettes that contain standalone BACKUP. They are labeled as 
follows: 





Paper Label’ Volume Label” 





S/A BKUP TU58 V5.0 1/5 SYSTEM_1 
S/A BKUP TU58 V5.0 2/5 SYSTEM_2 
S/A BKUP TU58 V5.0 3/5 SYSTEM_3 
S/A BKUP TU58 V5.0 4/5 SYSTEM_4 
S/A BKUP TU58 V5.0 5/5 BACKUP 





1A paper label is a label affixed to a tape cassette. 


2A volume label is the name the VMS operating system uses to refer to a tape cassette. 
The procedure displays the volume label, not the paper label, in messages. 
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The procedure asks you to place the five tape cassettes containing standalone 
BACKUP, successively, in the console drive. 


1 


Make sure the console TU58 is in the CSA2 tape cassette drive. Insert the 
tape cassette labeled S/A BKUP TU58 V5.0 1/5 in the CSA1 drive. At 
the console-mode prompt (> > > ), enter the following command and 
press RETURN: 


>>> B CS1 
After a short time, the procedure displays the following message: 


Please remove the volume "SYSTEM_1" from the console device. 


Insert the first standalone system volume and enter "YES" when ready: 
Ignore this message and let the tape cassettes remain where they are. 


Type Y (for YES) and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_1", please stand by... 


Please remove the volume “SYSTEM_1" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


Remove the S/A BKUP TU58 V5.0 1/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 V5.0 2/5. When 
you are ready to continue, type Y and press RETURN. The procedure 
displays the following message: 


Resuming load operation on volume "SYSTEM_2", please stand by... 
VAX/VMS Version V5.0 31-DEC-1988 15:00 


Please remove the volume "SYSTEM_2" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


Remove the S/A BKUP TU58 V5.0 2/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 V5.0 3/5. When 
you are ready to continue, type Y and press RETURN. The procedure 
displays the following message: 

Resuming load operation on volume "SYSTEM_3", please stand by... 


Please remove the volume "SYSTEM_3" from the console device. 
Insert the next standalone system volume and enter "YES" when ready: 


Remove the S/A BKUP TU58 V5.0 3/5 tape cassette and insert the tape 
cassette labeled S/A BKUP TU58 V5.0 4/5 in the drive. When you are 
ready to continue, type Y and press RETURN. The procedure displays the 
following message: 


Resuming load operation on volume "SYSTEM_4", please stand by... 


The procedure might ask you for the date and time. Enter the date and 
time using the 24-hour clock format and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 31-DEC-1988 15:00 
The procedure displays a list of the devices on your system. For example: 


Available device DJAO: device type RA6O 
Available device DJA1: device type RA60 
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Check the list of devices. If the list is incomplete, make sure that all the 
drives are properly connected to the system. See your hardware manuals 
for details. 


The procedure displays the following message: 
Please remove the volume "SYSTEM_4" from the console device. 
Insert the standalone application volume and enter "YES" when ready: 


Remove the S/A BKUP TU58 V5.0 4/5 tape cassette from the CSA1 drive 
and insert the tape cassette labeled S/A BKUP TU58 V5.0 5/5. When 
you are ready to continue, type Y and press RETURN. The procedure 
displays the following message: 


Resuming load operation on volume 'BACKUP', please stand by... 


10 When standalone BACKUP finishes booting, it displays an identification 


message followed by the dollar-sign prompt ($): 
%BACKUP-I-IDENT, standalone BACKUP V5.0; the date is 31-DEC-1988 15:00 
$ 


To restore the system disk, follow the directions in Section 11.3. 





11.2 Backing Up the System Disk 


You should back up the system disk for the following reasons: 


In case a problem occurs during a VMS upgrade or update, or during the 
installation of other software products. Before you attempt any of these 
procedures you should back up the system disk. If a problem occurs, you 
can restore the backup copy of the system disk. 


To prevent loss of VMS files if they are accidentally deleted. After you 
install or upgrade the VMS operating system, or any other software 
products, you should back up the system disk. If a system file is deleted 
or renders the system disk inoperable, you can restore the backup copy 
and continue to use the system. 


In case the drive that holds the system disk malfunctions. If you have 
a backup copy of the VMS operating system, you can restore it to a 
functioning disk and continue to use the system. 


To eliminate disk fragmentation. Fragmentation happens when files are 
stored noncontiguously on the disk. The BACKUP command creates a 
copy on which files are stored contiguously. 


— If the system disk is removable, eliminating disk fragmentation is a 
one-step process. Use the backup copy as the new system disk. Store 
the old system disk in a safe place. 


— If the system disk is fixed, back it up to a disk or a magnetic tape. 
Then restore the files to the original system disk. 


DIGITAL recommends that you use standalone BACKUP, which uses a subset 
of Backup Utility qualifiers, to back up and restore your system disk. It is 
especially important that you understand the functions of the /IMAGE and 
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Backup Procedures 
11.2 Backing Up the System Disk 


Note: 


/PHYSICAL qualifiers to the BACKUP command before using standalone 


BACKUP. 

Qualifier Function 

/IMAGE Lets you create a functionally equivalent copy of the entire 
system disk 

/PHYSICAL Copies, saves, restores, or compares the entire system disk in 


terms of logical blocks, ignoring any file structure 


For a complete description of the Backup Utility and its qualifiers, see the 
VMS Backup Utility Manual. 


The procedure you use to back up a system disk on a VAX-11/725 or a 
VAX-11/730 depends on what type of system disk you have. 


The BACKUP command creates a system disk that includes a DIGITAL- 
provided set of volume parameters, including a CLUSTER_SIZE (disk 
access scheme) of one. (The CLUSTER _SIZE refers to the way files are 
stored on the disk, NOT to VAXclusters.) You can change most volume 
parameters later with the SET VOLUME command. However, to change 
the CLUSTER_SIZE you must back up the system disk to a disk that has 
been previously initialized with the CLUSTER_SIZE that you want. To 
prevent the BACKUP command from reinitializing the target disk, use the 
/NOINITIALIZE qualifier. For more information about initializing a disk, 
see the Guide to Maintaining a VMS System. For more information on the 
BACKUP command, see the VMS Backup Utility Manual. 


11.2.1 Backing Up an RC25 System Disk 


If you have a VAX-11/725, use the following procedure to back up the fixed 
RC25 system disk: 
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Obtain a scratch RC25 removable disk cartridge. Insert the disk cartridge 
in the disk cartridge drive and close the door. Press the WRITE PROTECT 
/REMOVE button out. Press the RUN button to bring the RC25 disk 
cartridge drive to operating speed. 


Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 


Write-protect the system disk by pushing the WRITE PROTECT /FIXED 
button in. 


Enter the following command and press RETURN: 
$ BACKUP/IMAGE/VERIFY DAA1: DAAO: 


When the procedure is finished, it displays the following message: 


“BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. Spin down the RC25 
drive and remove the backup disk cartridge. 
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11.2 Backing Up the System Disk 


Spin up the drive and reboot the system. 


Store the backup copy of the system disk in a safe place. The contents of a 
backup copy have to be restored to the RC25 fixed disk before you can use 
them. For more information, see Section 11.3.1. 


11.2.2 Backing Up an R80 System Disk 


If you have a VAX-11/730 with an R80 system disk, use the following 
procedure to back up the system disk: 


1 


2 
3 


8 
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Obtain a number of scratch RLO2 disks. Place the first one in the RLO2 
drive and spin up the drive. 


Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 


Write-protect the system disk by pressing the WRITE PROTECT button 
on the disk drive. 


Enter the following command: 
$ BACKUP/IMAGE/VERIFY DQAQ: DQA1: 


When standalone BACKUP is ready for the next scratch RLO2 disk, it 
displays the following message: 


Y%BACKUP-I-READYWRITE, Mount Volume 2 on _DQA1: for writing 
Press RETURN when READY: 


Spin down the RLO2 drive and remove the first RLO2 disk. Label this disk 
with the save set name and the number 1. 


Place the next scratch RLO2 disk in the drive. Spin up the drive. Press 
RETURN when you are ready to continue. 


Repeat steps 5 and 6 as needed. Remember to label each disk with the 
save set name and appropriate number. 
When the procedure is finished, it displays the following message: 


“BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. 
Reboot the system. 


Store the backup RLO2 disks in a safe place. The contents of the backup disks 
have to be restored to the R80 system disk before you can use them. For 
more information, see Section 11.3.2. 
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Backup Procedures 
11.2 Backing Up the System Disk 


11.2.3 Backing Up an RAGO, RA80, RA81, or RA82 System Disk 


If you have a VAX-11/730 with either an RA60, RA80, RA81, or RA82 
system disk, use the following procedure to back up the system disk: 
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Obtain a scratch disk or tape that you can use for the backup copy. Place 
it in the appropriate drive. If you are using a tape drive, put it on line. If 
you are using a disk drive, spin it up. 


Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 


Write-protect the system disk by pressing the WRITE PROTECT button 
on the disk drive. 


Determine the device names of the drive holding the system disk and the 
drive holding the backup disk or tape. For the list of device names for a 
VAX-11/730, see Table 3-1. 


Enter the BACKUP command in one of the following formats. If you are 
backing up the system disk to a disk, use the first command. If you are 
backing up the system disk to a magnetic tape, use the second command. 


$ BACKUP/IMAGE/VERIFY source-drive: target-drive: 


$ BACKUP/IMAGE/BUFFER=5/VERIFY source-drive: target-drive:saveset .BCK/REWIND/LABEL=volume-label 


where: 


¢ source-drive is the location of the files you want to backup. Use the 
device name of the drive holding the system disk. 


© target-drive is the destination. Use the device name of the drive 
holding the backup disk or tape. 


e  saveset.BCK is the name of the save set (the name should reflect the 
contents of the backup tape). 


¢ volume-label is the volume label of the tape in the target-drive. If 
the tape has already been initialized, use the same volume label that 
was assigned by the INITIALIZE command. If the tape has not been 
initialized, you can assign a volume label at this time. The volume 
label can have up to six characters. 


The following example uses the BACKUP command to make a backup 
disk. You can use a backup disk as a system disk. 


$ BACKUP/IMAGE/VERIFY DUAO: DUA1: 


The following example uses the BACKUP command to make a backup 
tape. The contents of a backup tape have to be restored to a disk before 
you can use them. For more information, see Section 11.3.3. 


$ BACKUP/IMAGE/BUFFER=5/VERIFY DUAQ: MSAO:DEC_31_1988.BCK/REWIND/LABEL=SYSDSK 


When the procedure is finished, it displays the following message: 


“BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. 
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Reboot the system. 


Store the backup copy of the system disk in a safe place. 
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11.3. Restoring the System Disk 


The procedure you use to restore a system disk on a VAX-11/725 ora 
VAX-11/730 depends on what type of system disk you have. 


11.3.1 Restoring an RC25 System Disk 


If you have a VAX-11/725, use the following procedure to restore the RC25 
fixed disk (the system disk): 


1 


Place the backup RC25 disk cartridge in the disk cartridge drive and close 
the door. Push the WRITE PROTECT/REMOVE button in. Press the 
RUN button to bring the RC25 disk cartridge drive to operating speed. 


Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 
Push the WRITE PROTECT/FIXED button out. 
Enter the following command and press RETURN: 


$ BACKUP/IMAGE/VERIFY DAAO: DAA1: 
When the procedure is finished, it displays the following message: 


Y%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. Spin down the RC25 
drive and remove the backup disk cartridge. 


Spin up the drive and reboot the system. 


11.3.2 Restoring an R80 System Disk 


If you have a VAX-11/730 with an R80 system disk, use the following 
procedure to restore it from backup RLO2 disks: 


1 


2 
3 


Place the first backup RLO2 disk in the RLO2 drive. Write-protect it and 
spin it up. 


Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 
Enter the following command and press RETURN: 


$ BACKUP/IMAGE/VERIFY DQA1: DQAO: 


When standalone BACKUP is ready for the next backup RLO2 disk, it 
displays the following message: 


%BACKUP-I-STARTVERIFY, starting verification pass 
/%BACKUP-I-RESUME, resuming operation on volume 2 
Y%BACKUP-I-READYREAD, mount volume 2 on _SABAKUP$DQAO: for reading 
Enter "YES" when ready: 
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4 Spin down the RLO2 drive and remove the first RLO2 disk. 


5 Place the next RLO2 disk in the drive. Spin up the drive. Press RETURN 
when you are ready to continue. 


Repeat steps 4 and 5 as needed. 


6 When the procedure is finished, it displays the following message: 
“%BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the systen. 
If you do want to perform another standalone BACKUP operation, 


ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


7 Press CTRL/P to put the system in console mode. 
8 Reboot the system. 


11.3.3 Restoring an RA6O, RA8O, RA81, or RA82 System Disk 
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If you have a VAX-11/730 with either an RA60, RA80, RA81, or RA82 
system disk, use the following procedure to restore the system disk: 


1 Place the backup disk or tape in an appropriate drive. If you are using a 
tape drive, put it on line. If you are using a disk drive, spin it up. 


2 Boot standalone BACKUP as described in Section 11.1.2 or Section 11.1.4. 


3 Place a scratch disk in the drive you intend to use for the new system 
disk. Spin it up but do not write-protect it. 


4 Determine the device names of the drive holding the system disk and the 
drive holding the backup disk or tape. For the list of device names for a 
VAX-11/730, see Table 3-1. 


5 Enter the BACKUP command in one of the following formats. If you 
have a backup disk, use the first command. If you have backup tape, use 
the second command. 


$ BACKUP/IMAGE/VERIFY source-drive: target-drive: 


$ BACKUP/IMAGE/BUFFER=5/VERIFY source-drive:saveset .BCK/REWIND target-drive 
where: 


¢ source-drive is the location of the files you want to restore. Use the 
device name of the drive holding the backup disk or tape. 


¢  saveset is the name of the save set, if you have a backup tape. 


© target-drive is the destination. Use the device name of the drive 
holding the system disk. 


The following example uses the BACKUP command to restore the system 
disk from a backup disk. 


$ BACKUP/IMAGE/VERIFY DUA1: DUAO: 


The following example uses the BACKUP command to restore the system 
disk from a backup tape. 


$ BACKUP/IMAGE/BUFFER=5/VERIFY MSAO:DEC_31_1988.BCK/REWIND DUA1: 


Backup Procedures 
11.3 Restoring the System Disk 


When the procedure is finished, it displays the following message: 


“BACKUP-I-PROCDONE, Operation completed. Processing finished at 31-DEC-1988 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Press CTRL/P to put the system in console mode. 
Reboot the system. 


11.4 Backing Up the Console TU58 


Make a backup copy of the console TU58 to protect against corruption or loss 
of the original. You need the original console TU58 and a scratch TU58 tape 
cassette. 


To back up the console TU58, use the following procedure: 


1 


a & WN 


Write-enable the console TU58. Push the black RECORD switch in the 
upper left hand corner of the tape cassette to the left. 


Insert the console TU58 in the console tape cassette drive (CSA2). 
Insert the scratch TU58 tape cassette in CSA1. 
Log into the SYSTEM account. 


To connect the console drives to the system, enter the following 
commands and press RETURN after each one: 


$ RUN SYS$SYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


Enter the following command and press RETURN: 
$ BACKUP/PHYSICAL/VERIFY CSA2: CSA1: 
The procedure takes approximately 30 minutes. 


When you are finished, enter the following commands and press 
RETURN after each one: 


$ DISMOUNT CSA1 
$ DISMOUNT CSA2 


To secure the console TU58 from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA2 


Use the console TU58 that you just created to make sure it works. Treat the 
original as the backup copy. 
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A Redefining the Line Printer on a VAX—11/730 


Line printer device names on VAX-11/730 processors that use a DMF32 
“combo” board are defined as LC. All other line printer names are defined 
as LP. To avoid problems with programs and procedures that use the LP 
designation, you should redefine the line printer device name. Add the 


following commands to the site-specific SYSTARTUP_V5.COM command 
procedure: 


$ DEFINE /SYSTEM LP LCAO: 

$ DEFINE /SYSTEM LPO LCAO: 
$ DEFINE /SYSTEM LPA LCAO: 
$ DEFINE /SYSTEM LPAO LCAO: 





Glossary 


boot or bootstrap: The process of loading system software into a processor’s main 
memory. This guide uses the term boot to refer to this process. 


boot command procedure: A program stored on the console TU58 that is used to 
boot the VMS operating system from a specified drive. DIGITAL provides a boot 
command procedure for each device that the processor supports. 


boot name: The abbreviated name of the boot command procedure you use to boot 
the system. 


console TU58: The TU58 tape cartridge that contains the console program. It is 
not shipped as part of the VMS distribution kit. It comes with the hardware. The 
console TU58 is used in the CSA2 tape cartridge drive. 


device name: The name you use to identify a device on the system. A device name 
indicates the device code, controller designation, and unit number. 


local drive: Any drive that is connected directly to a processor is referred to as a local 
drive. 


media: A generic term that refers to any packaging agent capable of storing computer 
software. Examples of media are magnetic tapes, floppy diskettes, disk packs, tape 
cartridges, etc. 


save set: The format that the Backup Utility stores files in. The VMS operating system 
is shipped in this format. 


scratch disk: A blank disk or a disk with files that you no longer need. 
source-drive: The drive that holds the distribution magnetic tape. 


spin up/spin down: To spin up means to bring a disk drive up to operating speed. To 
spin down means to bring it to a gradual stop. 


standalone BACKUP: A version of the Backup Utility that runs from memory without 
the control of the VMS operating system. 


standalone system: A computer system with only one VAX computer. 

system disk: The disk that contains (or will contain) the VMS operating system. 

target-drive: The drive that holds the system disk. 

VMS User Environment Test Package (UETP): A software package that tests all 
the standard peripheral devices on your system, various commands and operating 


system functions, the system's multi-user capability, and DECnet-VAX. 


VMSTAILOR: A software program that lets you customize your system disk. 
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problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


I rate this manual's: Excellent Good Fair Poor 
Accuracy (software works as manual says) O Oo oO oO 
Completeness (enough information) Oo O Oo Oo 
Clarity (easy to understand) Oo Oo O oO 
Organization (structure of subject matter) O Oo O O 
Figures (useful) Oo oO O O 
Examples (useful) O Oo O O 
Index (ability to find topic) Oo O oO O 
Page layout (easy to find information) O O Oo oO 


I would like to see more/less 











What I like best about this manual is 








What I like least about this manual is 





I found the following errors in this manual: 
Page Description 























Additional comments or suggestions to improve this manual: 








I am using Version of the software this manual describes. 
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